D3DM_GETINFO_DATA (Windows Embedded CE 6.0)

1/6/2010

This structure is used to describe a request for additional information from the driver beyond what it already provides with D3DM_GETADAPTERINFO_DATA. A pointer to this structure is passed as a parameter to the D3DM_GetInfo function.

Syntax

typedef struct _D3DM_GETINFO_DATA {
  ULONG nContextId;
  DWORD DevInfoId;
  void* pDevInfoStruct;
  DWORD DevInfoStructSize;
  HRESULT rval;
} D3DM_GETINFO_DATA;

Members

• nContextId
  A ULONG value identifying the rendering context to retrieve the information from.

• DevInfoId
  A DWORD value defined by the driver's design that identifies the function a driver should perform or the data the driver should retrieve.

  This value should be set to one of the D3DM_GETINFO Values. This value indicates to the driver that the pDevInfoStruct member is a pointer to a D3DMCLIPSTATUS structure. As a result, the value for DevInfoStructSize is sizeof(D3DMCLIPSTATUS).

  Upon receiving D3DM_SETINFO_SETCLIPSTATUS_DEVINFOID, the driver is expected to copy the clip status structure into its own internal clipping status variables.

  Upon receiving D3DM_GETINFO_GETCLIPSTATUS_DEVINFOID, the driver is expected to fill out the clip status bits with its own internal clip status bits and return.

  A Direct3D Mobile driver is not required to support D3DM_SETINFO_SETCLIPSTATUS_DEVINFOID or D3DM_GETINFO_GETCLIPSTATUS_DEVINFOID. If it does support these values, then it must expose the D3DMVTXPCAPS_CLIPSTATUS capability bit (see D3DMVTXPCAPS Values).

• pDevInfoStruct
  A void pointer to a buffer allocated by the application that will contain the results from a call to D3DM_GetInfo.

• DevInfoStructSize
  A DWORD value identifying the size of the buffer, in bytes, that pDevInfoStruct points to.

• rval
  An HRESULT value containing an error code reported by the driver to describe any problems it encountered while trying to populate the members of this structure. If the driver did not encounter any errors, it sets this value to D3DM_OK to indicate success.

Requirements

See Also

Reference

Direct3D Mobile Driver Structures
D3DM_GETADAPTERINFO_DATA
D3DM_GetInfo
D3DM_GETINFO Values

Concepts

Additional Information from the Direct3D Mobile Driver

Other Resources

D3DMCLIPSTATUS
D3DMVTXPCAPS Values