Edit

DD_GETDDIVERSIONDATA structure (d3dhal.h)

  • Article

DirectX 9.0 and later versions only.

DD_GETDDIVERSIONDATA is the data structure pointed to by the lpvData field of DD_GETDRIVERINFODATA for DD_GETDRIVERINFO2DATA queries with the type D3DGDI2_TYPE_GETDDIVERSION.

Syntax

typedef struct _DD_GETDDIVERSIONDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  DWORD                 dwDXVersion;
  DWORD                 dwDDIVersion;
} DD_GETDDIVERSIONDATA;

Members

gdi2

Specifies a DD_GETDRIVERINFO2DATA structure that contains the GetDriverInfo2 data for the query.

dwDXVersion

Specifies the version of the DirectX runtime that makes the request. For example, the DirectX 9.0 runtime specifies 9.

dwDDIVersion

Receives the version of the DDI that the driver supports.

Remarks

During the development phase of a version of DirectX, whenever a significant change is made to the Driver Development Kit (DDK) headers, the version number of the DDI is updated. Thereafter, a display driver must report this updated DDI version in order to be run as the most-recent-version DirectX driver. If the driver does not report this updated DDI version, the runtime determines that the driver is the prior version of DirectX and handles the driver accordingly.

For example, suppose that a hardware vendor builds his display driver with a pre-released version of the DirectX 9.0 DDK and then attempts to ship his driver as a DirectX 9.0 version. If the DDI version number is updated in the final version of DirectX 9.0, the DirectX 9.0 runtime subsequently treats this driver as a DirectX 8.0 version driver instead.

Requirements

Requirement Value
Header d3dhal.h (include D3dhal.h)

See also

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA