Microsoft DirectX 8.0 (C++)

IDirect3D8::RegisterSoftwareDevice

Registers a pluggable software device with Microsoft® Direct3D®.

HRESULT RegisterSoftwareDevice(
  void* pInitializeFunction
);

Parameters

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

Return Values

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_INVALIDCALL
D3DERR_OUTOFVIDEOMEMORY

Remarks

Software rasterization for Direct3D is provided by pluggable software devices, enabling applications to access a variety of software rasterizers through the Direct3D interfaces. 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.

Requirements

  Header: Declared in D3d8.h.
  Import Library: Use D3d8.lib.