функция обратного вызова DXGKDDI_QUERYADAPTERINFO (d3dkmddi.h)
Функция 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 (то есть предоставил частные данные для запроса к драйверу минипорта дисплея). |
Комментарии
Когда драйвер отображения пользовательского режима вызывает функцию pfnQueryAdapterInfoCb , инициируется вызов функции 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 |