IDirect3DMobile::RegisterSoftwareDevice (Windows CE 5.0)

Send Feedback

This method registers a pluggable software device with Microsoft® Direct3D Mobile®.

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 D3DM_OK, see D3DM Values.

If the method fails, the return value can be one of the following D3DMERR Values:

  • D3DMERR_INVALIDCALL
  • D3DERR_MEMORYPOOLEMPTY

Remarks

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

Direct3D Mobile software devices communicate with Direct3D Mobile through an interface similar to the hardware device driver interface (DDI). For more information, see Direct3D Mobile Display Drivers.

Requirements

OS Versions: Windows CE 5.0 and later.
Header: D3dm.h.
Link Library: D3dm.lib, D3dmguid.lib.

See Also

IDirect3DMobile | Registration of a Software Device | Direct3D Mobile Display Drivers

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.