Edit

D3DKMT_ENUMADAPTERS3 structure (d3dkmthk.h)

  • Article

Supplies information about adapters on the system.

Syntax

typedef struct _D3DKMT_ENUMADAPTERS3 {
  [in]     D3DKMT_ENUMADAPTERS_FILTER Filter;
  [in/out] ULONG                      NumAdapters;
  [out]    D3DKMT_ADAPTERINFO         *pAdapters;
} 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.

Value Meaning
IncludeComputeOnly When set, enumerate ComputeOnly adapters.
IncludeDisplayOnly When set, enumerate DisplayOnly adapters.
Reserved Reserved; do not use.

[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.

[out] pAdapters

An optional array of D3DKMT_ADAPTERINFO structures in which to receive information for each adapter.

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

Requirement Value
Minimum supported client Windows 10, version 2004
Header d3dkmthk.h

See also

D3DKMT_ADAPTERINFO

D3DKMTEnumAdapters3

PFND3DKMT_ENUMADAPTERS3