Edit

DD_GETADAPTERGROUPDATA structure (d3dhal.h)

  • Article

DirectX 9.0 and later versions only.

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

Syntax

typedef struct _DD_GETADAPTERGROUPDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  ULONG_PTR             ulUniqueAdapterGroupId;
  DWORD                 dwReserved1;
  DWORD                 dwReserved2;
} DD_GETADAPTERGROUPDATA;

Members

gdi2

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

ulUniqueAdapterGroupId

Receives the identifier of the group of adapters that comprise the driver's multiple-head video card. The driver must provide a unique identifier for the master and all subordinate adapters within this group.

dwReserved1

Specifies a reserved field. Driver should not read or write. Set to zero.

dwReserved2

Specifies a reserved field. Driver should not read or write. Set to zero.

Remarks

The runtime uses DD_GETADAPTERGROUPDATA in a query for the identity of the driver's group of adapters. This group shares video hardware like video memory and the 3D accelerator. The runtime mainly uses this query for dual-view video adapters. An application can request that surface resources (like textures and vertex buffers) be shared across adapters in a group and the runtime complies with that request.

The identifier in ulUniqueAdapterGroupId must be unique across drivers, including drivers from other hardware vendors. Therefore, it is recommended to report this identifier as a unique kernel-mode address that cannot be common with other multiple-head video cards. Note that the driver must report this identifier as nonzero.

Requirements

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

See also

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA