функция обратного вызова DXGKDDI_QUERYADAPTERINFO (d3dkmddi.h)

Статья
05/23/2024

Функция DxgkDdiQueryAdapterInfo минипорта дисплея (KMD) извлекает сведения о конфигурации из графического адаптера.

Синтаксис

DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;

NTSTATUS DxgkddiQueryadapterinfo(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}

Параметры

[in] hAdapter

Дескриптор для блока контекста, связанного с видеоадаптером. KMD ранее предоставлял этот дескриптор Dxgkrnl в выходном параметре MiniportDeviceContext функции DxgkDdiAddDevice .

[in] pQueryAdapterInfo

Указатель на структуру DXGKARG_QUERYADAPTERINFO , которую KMD заполняет сведениями о конфигурации графического адаптера.

Возвращаемое значение

DxgkDdiQueryAdapterInfo возвращает одно из следующих значений:

Код возврата	Описание
STATUS_SUCCESS	DxgkDdiQueryAdapterInfo успешно извлек сведения о конфигурации.
STATUS_INVALID_PARAMETER	Параметры, переданные в DxgkDdiQueryAdapterInfo, содержали ошибки, которые не позволяли завершить его.
STATUS_NO_MEMORY	DxgkDdiQueryAdapterInfo не удалось выделить память, необходимую для ее завершения.
STATUS_GRAPHICS_DRIVER_MISMATCH	Драйвер мини-порта дисплея несовместим с драйвером дисплея в пользовательском режиме, который инициировал вызов DxgkDdiQueryAdapterInfo (то есть предоставил частные данные для запроса к драйверу минипорта дисплея).

Если DxgkDdiQueryAdapterInfo получает значение DXGKQAITYPE_UMDRIVERPRIVATE в элементе Typeструктуры DXGKARG_QUERYADAPTERINFO , на которую указывает параметр pQueryAdapterInfo , pOutputData указывает на собственную структуру, которая KMD заполняет сведениями о конфигурации, необходимыми для идентификации адаптера драйвером отображения в пользовательском режиме.

Если Dxgkrnl указывает значение DXGKQAITYPE_DRIVERCAPS в элементе Type DXGKARG_QUERYADAPTERINFO когда подсистема вызывает DxgkDdiQueryAdapterInfo, драйвер мини-порта дисплея должен заполнить предоставленную структуру DXGK_DRIVERCAPS сведениями, которые может использовать подсистема.

Если подсистема ядра графики DirectX предоставляет значение DXGKQAITYPE_QUERYSEGMENT в элементе Type DXGKARG_QUERYADAPTERINFO, драйвер мини-порта дисплея должен предоставить сведения о поддерживаемых сегментах памяти. Дополнительные сведения о сегментах памяти см. в разделе Инициализация использования сегментов памяти.

DxgkDdiQueryAdapterInfo должен быть доступным для страниц.

Все драйверы, поддерживающие WDDM 2.6 и более поздней версии, должны реализовывать обратный вызов DxgkDdiQueryAdapterInfo .

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Целевая платформа	Персональный компьютер
Верхняя часть	d3dkmddi.h
IRQL	PASSIVE_LEVEL

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

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb

Поделиться через