?/TD>
Microsoft DirectX 9.0

IDirect3D9::RegisterSoftwareDevice Method


Registers a pluggable software device. Software devices provide software rasterization enabling applications to access a variety of software rasterizers.

Syntax

HRESULT RegisterSoftwareDevice(      

    void *pInitializeFunction );

Parameters

pInitializeFunction
[in] Pointer to the initialization function for the software device to be registered.

Return Value

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be one of the following values.

D3DERR_INVALIDCALLThe method call is invalid. For example, a method's parameter may have an invalid value.
D3DERR_OUTOFVIDEOMEMORYDirect3D does not have enough display memory to perform the operation.


Remarks

If the user's computer provides no special hardware acceleration for 3-D operations, your application might emulate 3-D hardware in software. Software rasterization devices emulate the functions of color 3-D hardware in software. A software device runs more slowly than a hardware abstraction layer (HAL). However, software devices take advantage of any special instructions supported by the CPU to increase performance. Instruction sets include the AMD 3DNow! instruction set on some AMD processors and the MMX instruction set supported by many Intel processors. Microsoft?Direct3D?uses the 3D-Now! instruction set to accelerate transformation and lighting operations and the MMX instruction set to accelerate rasterization.

Software devices communicate with Direct3D through an interface similar to the hardware device driver interface (DDI).

Software devices are loaded by the application and registered with the IDirect3D9 object. Direct3D uses the software device for rendering.

The Direct3D Driver Development Kit (DDK) provides the documentation and headers for developing pluggable software devices.



© 2002 Microsoft Corporation. All rights reserved.