структура D3DKMT_ENUMADAPTERS3 (d3dkmthk.h)

  • Статья

Предоставляет сведения об адаптерах в системе.

Синтаксис

typedef struct _D3DKMT_ENUMADAPTERS3 {
  [in]     D3DKMT_ENUMADAPTERS_FILTER Filter;
  [in/out] ULONG                      NumAdapters;
  [out]    D3DKMT_ADAPTERINFO         *pAdapters;
} D3DKMT_ENUMADAPTERS3;

Члены

[in] Filter

Объединение D3DKMT_ENUMADAPTERS_FILTER, содержащее флаги фильтра для перечисления. В фильтре может быть побитовое или из следующих значений. Дополнительные сведения см. в разделе "Примечания".

Значение Значение
IncludeComputeOnly Если этот параметр задан, перечислите адаптеры ComputeOnly.
IncludeDisplayOnly Если этот параметр задан, перечислите адаптеры DisplayOnly.
Зарезервировано Защищены; не использовать.

[in/out] NumAdapters

Количество адаптеров.

На входных данных NumAdapters указывает, сколько адаптеров может быть возвращено в пустом массиве pAdapters . Возможные возвращаемые значения для NumAdapters :

  • При успешном возвращении, когда pAdapters не равно NULL, NumAdapters содержит количество адаптеров, возвращенных в массиве pAdapters .
  • При успешном возвращении, когда pAdapters имеет значение NULL, NumAdapters содержит максимальное поддерживаемое число адаптеров.
  • При сбое возврата, если pAdapters не равно NULL, NumAdapters не определен.

[out] pAdapters

Необязательный массив D3DKMT_ADAPTERINFO структур, в которых необходимо получать сведения для каждого адаптера.

Комментарии

Адаптеры по-прежнему будут перечисляться, если в фильтре не заданы флаги, но D3DKMTEnumAdapters3 будет перечислять меньше адаптеров, чем D3DKMTEnumAdapters2. В частности, D3DKMTEnumAdapters3 :

  • Оставьте адаптеры ComputeOnly из перечисления по умолчанию, чтобы избежать нарушения работы приложений.
  • Оставьте адаптеры DisplayOnly из перечисления по умолчанию.

Требования

Требование Значение
Минимальная версия клиента Windows 10 версии 2004
Верхняя часть d3dkmthk.h

См. также раздел

D3DKMT_ADAPTERINFO

D3DKMTEnumAdapters3

PFND3DKMT_ENUMADAPTERS3