DXGKDDI_QUERYADAPTERINFO función de devolución de llamada (d3dkmddi.h)
Dxgkrnl llama a la función de DxgkDdiQueryAdapterInfo del controlador de miniporte de pantalla para recuperar información de configuración del adaptador de gráficos.
Sintaxis
DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;
NTSTATUS DxgkddiQueryadapterinfo(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}
Parámetros
[in] hAdapter
Identificador de un bloque de contexto asociado a un adaptador de pantalla. El KMD previamente proporcionó este identificador para Dxgkrnl en la función MiniportDeviceContext del DxgkDdiAddDevice función.
[in] pQueryAdapterInfo
Puntero a una estructura de DXGKARG_QUERYADAPTERINFO que el KMD rellena con la información de configuración del adaptador de gráficos.
Valor devuelto
dxgkDdiQueryAdapterInfo devuelve STATUS_SUCCESS cuando recupera correctamente la información de configuración. De lo contrario, devuelve un código NTSTATUS, como uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| STATUS_INVALID_PARAMETER | Uno o más parámetros pasados contenían errores que impedían que se completara. |
| STATUS_NO_MEMORY | DxgkDdiQueryAdapterInfo no se pudo asignar memoria necesaria para que se complete. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | El KMD no es compatible con el controlador de pantalla en modo de usuario (UMD) que inició la llamada a dxgkDdiQueryAdapterInfo (es decir, los datos privados proporcionados para una consulta al KMD). |
Observaciones
Cuando el UMD llama al pfnQueryAdapterInfoCb del runtime de Direct3D devolución de llamada, se inicia una llamada a la función DxgkDdiQueryAdapterInfo.
Si Dxgkrnl especifica DXGKQAITYPE_UMDRIVERPRIVATE en DXGKARG_QUERYADAPTERINFO::Type, pOutputData apunta a una estructura propietaria que KMD rellena con la información de configuración necesaria para que el UMD identifique el adaptador.
Si dxgkrnl especifica DXGKQAITYPE_DRIVERCAPS en DXGKARG_QUERYADAPTERINFO::Type, el KMD debe rellenar la estructura DXGK_DRIVERCAPS proporcionada con información que el subsistema puede usar.
Si dxgkrnl especifica DXGKQAITYPE_QUERYSEGMENT en DXGKARG_QUERYADAPTERINFO::Type, el KMD debe proporcionar información sobre los segmentos de memoria que admite. Para obtener más información sobre los segmentos de memoria, vea Inicializar el uso de segmentos de memoria.
dxgkDdiQueryAdapterInfo debe ser paginable.
Todos los controladores compatibles con WDDM 2.6 y versiones posteriores deben implementar la devolución de llamada DxgkDdiQueryAdapter Info.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista (WDDM 1.0) |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dkmddi.h |
| irQL | PASSIVE_LEVEL |