функция обратного вызова DXGKDDI_QUERYADAPTERINFO (d3dkmddi.h)
Dxgkrnl вызывает функцию драйвера минипорта (KMD) дисплея DxgkDdiQueryAdapterInfo для получения сведений о конфигурации из графического адаптера.
Синтаксис
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 при успешном получении сведений о конфигурации. В противном случае возвращается код NTSTATUS, например один из следующих значений:
| Возвращаемый код | Описание |
|---|---|
| STATUS_INVALID_PARAMETER | Один или несколько переданных параметров содержали ошибки, которые препятствовали завершению. |
| STATUS_NO_MEMORY | DxgkDdiQueryAdapterInfo не удалось выделить память, необходимую для завершения. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | KMD несовместим с драйвером отображения в пользовательском режиме (UMD), инициирующим вызов DxgkDdiQueryAdapterInfo (т. е. предоставленные частные данные для запроса к KMD). |
Замечания
Когда UMD вызывает среды выполнения Direct3D pfnQueryAdapterInfoCb обратного вызова, инициируется вызов функции DxgkDdiQueryAdapterInfo.
Если Dxgkrnl указывает DXGKQAITYPE_UMDRIVERPRIVATE в DXGKARG_QUERYADAPTERINFO::Type, pOutputData указывает на собственную структуру, которая KMD заполняет сведения о конфигурации, необходимые для идентификации адаптера.
Если Dxgkrnl указывает DXGKQAITYPE_DRIVERCAPS в DXGKARG_QUERYADAPTERINFO::Type, KMD должен заполнить предоставленную структуру DXGK_DRIVERCAPS сведениями, которые подсистема может использовать.
Если Dxgkrnl указывает DXGKQAITYPE_QUERYSEGMENT в DXGKARG_QUERYADAPTERINFO::Type, KMD должен предоставить сведения о поддерживаемых сегментах памяти. Дополнительные сведения о сегментах памяти см. в инициализации использования сегментов памяти.
DxgkDdiQueryAdapterInfo должен быть доступен для страницы.
Все драйверы, поддерживающие WDDM 2.6 и больше, должны реализовать обратный вызов DxgkDdiQueryAdapterInfo.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista (WDDM 1.0) |
| целевая платформа | Настольный |
| заголовка | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |