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

  • Статья

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

Синтаксис

DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;

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

Параметры

[in] hAdapter

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

[in] pQueryAdapterInfo

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

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

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

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

Комментарии

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

Если подсистема ядра графики DirectX (которая является частью Dxgkrnl.sys) задает значение 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