DD_GETEXTENDEDMODEDATA structure (d3dhal.h)
DirectX 9.0 and later versions only.
DD_GETEXTENDEDMODEDATA is the data structure pointed to by the lpvData field of DD_GETDRIVERINFODATA for DD_GETDRIVERINFO2DATA queries with the type D3DGDI2_TYPE_GETEXTENDEDMODE.
Syntax
typedef struct _DD_GETEXTENDEDMODEDATA {
DD_GETDRIVERINFO2DATA gdi2;
DWORD dwModeIndex;
D3DDISPLAYMODE mode;
} DD_GETEXTENDEDMODEDATA;
Members
gdi2
Specifies a DD_GETDRIVERINFO2DATA structure that contains the GetDriverInfo2 data.
dwModeIndex
Specifies the index of the display mode to return.
mode
Receives a D3DDISPLAYMODE structure that specifies the actual display mode.
Remarks
The runtime identifies the display mode to be returned with an integer index whose value varies between zero and one less than the number of supported display modes that were reported earlier by the driver in a DD_GETDRIVERINFO2DATA query with the type D3DGDI2_TYPE_GETEXTENDEDMODECOUNT. How these indices are mapped to actual display modes is left to the driver. However, each index must map uniquely to one supported display mode. The order in which the display modes are reported is not significant.
When processing this GetDriverInfo2 request the driver should read the value in the dwModeIndex member and map that value to one of the supported display modes (probably by using the value in dwModeIndex as an index into an array of D3DDISPLAYMODE structures). The driver should then copy that display mode into the mode member. The runtime guarantees that it only passes an index to the driver that is in the range zero to one less than the number of display modes reported by the driver. The range of the index should be validated in the debug driver build.
For more information about D3DDISPLAYMODE, see the DirectX SDK documentation.
Requirements
| Requirement | Value |
|---|---|
| Header | d3dhal.h (include D3dhal.h) |