IDirect3D8::RegisterSoftwareDevice

This method registers 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

OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8.h.
Link Library: D3d8.lib.

See Also

IDirect3D8

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.