Microsoft DirectX 8.0 (Visual Basic)

Direct3D8.RegisterSoftwareDevice

Registers a pluggable software device with Microsoft® Direct3D®.

object.RegisterSoftwareDevice( _ 
    InitializeFunction As Any)

Parts

object
Object expression that resolves to a Direct3D8 object.
InitializeFunction
Initialization function for the software device to be registered.

Error Codes

If the method fails, an error is raised and Err.Number can be set to one of the following values.

D3DERR_INVALIDCALL
D3DERR_OUTOFVIDEOMEMORY

For information on trapping errors, see the Microsoft® Visual Basic® Error Handling topic.

Remarks

Software rasterization for Direct3D is provided by pluggable software devices, enabling applications to access a variety of software rasterizers through the Direct3D objects. Software devices are loaded by the application and registered with the Direct3D object, at which point a Direct3DDevice object can be created that will perform rendering with the software device.

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

The Direct3D DDK provides the documentation and headers for developing pluggable software devices.