Share via


D3DM_GETINFO_DATA (Windows CE 5.0)

Send Feedback

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.

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

OS Versions: Windows CE 5.0
Header: D3dmddk.h.

See Also

Direct3D Mobile Driver Structures | D3DM_GETADAPTERINFO_DATA | D3DM_GetInfo | D3DM_GETINFO Values | D3DMCLIPSTATUS | D3DMVTXPCAPS Values | Additional Information from the Direct3D Mobile Driver

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.