D3DKMT_ENUMADAPTERS3 structure (d3dkmthk.h)

Supplies information about adapters on the system.

Syntax

typedef struct _D3DKMT_ENUMADAPTERS3 {
  [in]     D3DKMT_ENUMADAPTERS_FILTER Filter;
  [in/out] ULONG                      NumAdapters;
  void                       D3DKMT_PTR(
    D3DKMT_ADAPTERINFO *unnamedParam1,
    pAdapters          unnamedParam2
  );
} D3DKMT_ENUMADAPTERS3;

Members

[in] Filter

A D3DKMT_ENUMADAPTERS_FILTER union containing filter flags for the enumeration. The struct in Filter can be a bitwise OR of the following values. See Remarks for more information.

[in/out] NumAdapters

The number of adapters.

On input, NumAdapters specifies how many adapters can be returned in the empty pAdapters array. Possible return values for NumAdapters are:

• On successful return when pAdapters is non-null, NumAdapters contains how many adapters were returned in the pAdapters array.
• On successful return when pAdapters is null, NumAdapters contains the maximum supported adapter count.
• On failed return when pAdapters is non-null, NumAdapters is undefined.

void D3DKMT_PTR( D3DKMT_ADAPTERINFO *unnamedParam1, pAdapters unnamedParam2)

Remarks

Adapters will still be enumerated if no flags are set in Filter, but D3DKMTEnumAdapters3 will enumerate fewer adapters than D3DKMTEnumAdapters2. Specifically, D3DKMTEnumAdapters3 will:

• Leave out ComputeOnly adapters from the default enumeration, to avoid breaking applications.
• Leave out DisplayOnly adapters from the default enumeration.

Requirements

See also

D3DKMT_ADAPTERINFO

D3DKMTEnumAdapters3

PFND3DKMT_ENUMADAPTERS3