структура D3DKMT_ENUMADAPTERS3 (d3dkmthk.h)
Структура D3DKMT_ENUMADAPTERS3 предоставляет сведения об адаптерах в системе.
Синтаксис
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. |
| IncludeVirtualGpuOnly | При установке перечислите адаптеры GPU-P. Эти адаптеры предназначены для использования только в виртуальных машинах. Драйвер задает DXGK_DRIVERCAPS::MiscCaps.VirtualGpuOnly ограничение для таких адаптеров, чтобы избежать перечисления в ос узла. Доступно начиная с Windows 11 версии 24H2 (WDDM 3.2). |
| Скрытный | Скрытный; не используйте. |
[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 |