IDirect3DMobile::RegisterSoftwareDevice (Windows Embedded CE 6.0)

  • Article

1/6/2010

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

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 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 about Direct3D in Windows Embedded CE, see Direct3D Mobile Display Drivers.

Requirements

Header d3dm.h
Library D3dm.lib, D3dmguid.lib
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

IDirect3DMobile

Concepts

Registration of a Software Device

Other Resources

Direct3D Mobile Display Drivers