D3DM_GetAdapterInfo (Windows Embedded CE 6.0)

1/6/2010

This function is used by the Direct3D Mobile middleware to gather information from the driver about the graphics device. The information about the driver is transmitted through a D3DM_GETADAPTERINFO_DATA structure. It is the driver's responsibility to provide as much and as accurate information as possible to the middleware each time this function is called.

Syntax

typedef DWORD (*D3DM_GETADAPTERINFO_PTR)(D3DM_GETADAPTERINFO_DATA *);

Parameters

• D3DM_GETADAPTERINFO_DATA
  [out] A pointer to a D3DM_GETADAPTERINFO_DATA structure that will contain information about the display driver.

Return Value

Implement this function so that it returns D3DM_DRIVER_HANDLED when it succeeds and D3DM_DRIVER_NOTHANDLED when it fails.

Remarks

The middleware does not cache any device information. Each time it needs a specific piece of information, it calls D3DM_GetAdapterInfo. This allows the driver to continually report the latest information to the middleware.

In many instances, the middleware calls D3DM_GetAdapterInfo when it needs only a subset of the possible information that the D3D_GETADAPTERINFO_DATA structure can contain. In these cases, the middleware sets the values of unneeded members to NULL. It is the driver's responsibility to operate efficiently by detecting these NULL values and then not populating those members with values. The driver must provide data for all non-NULL members.

Requirements

See Also

Reference

Direct3D Mobile Driver Functions
D3DM_GETADAPTERINFO_DATA

Concepts

Additional Information from the Direct3D Mobile Driver