Функция D3DKMTEnumAdapters3 (d3dkmthk.h)
Предоставляет сведения о перечислении графических и отображаемых адаптеров в системе.
Синтаксис
NTSTATUS D3DKMTEnumAdapters3(
[in/out] D3DKMT_ENUMADAPTERS3 *unnamedParam1
);
Параметры
[in/out] unnamedParam1
Структура D3DKMT_ENUMADAPTERS3. Вызывающий объект передает размер массива и пустое пространство массива. Вызывающий объект проверяет, есть ли в массиве достаточно места, заполняет массив и передает обратно количество использованного массива.
Возвращаемое значение
Эта функция возвращает NTSTATUS.
| Код возврата | Описание |
|---|---|
| STATUS_BUFFER_TOO_SMALL | Предоставленный массив слишком мал, чтобы получить все адаптеры. |
| STATUS_INVALID_PARAMETER | Элемент pEnumAdapters имеет значение NULL или является недопустимым регионом памяти. |
| STATUS_NO_MEMORY | Память не может быть выделена для удовлетворения операции. |
Замечания
Если параметр D3DKMT_ENUMADAPTERS3::p Adapters имеет значение NULL, для параметра D3DKMT_ENUMADAPTERS3::NumAdapters установлено максимальное число поддерживаемых адаптеров. Вызовы обычно вызывают метод, сначала для получения максимального поддерживаемого количества адаптеров.
Когда вызывающий объект успешно перечисляет адаптеры, он отвечает за явное управление сроком существования адаптера D3DKMT_HANDLEs. Эти дескрипторы возвращаются вызывающей стороны через pEnumAdapters, и они должны быть закрыты с D3DKMTCloseAdapter.
Настройка ни одного из флагов D3DKMT_ENUMADAPTERS3::Filter по-прежнему перечисляет адаптеры, но есть меньше адаптеров, чем перечисления D3DKMTEnumAdapters2. Адаптеры ComputeOnly остаются вне перечисления по умолчанию, чтобы избежать нарушения работы приложений. Адаптеры DisplayOnly также остаются без перечисления по умолчанию.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 10 версии 2004 |
| целевая платформа | Виндоус |
| заголовка | d3dkmthk.h (include D3dkmthk.h) |
| библиотеки |
onecoreuap.lib |
| DLL | Gdi32.dll |