DXGKDDI_QUERYADAPTERINFO función de devolución de llamada (d3dkmddi.h)
La función DxgkDdiQueryAdapterInfo de la miniporte de pantalla (KMD) recupera la 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 proporcionó anteriormente este identificador a Dxgkrnl en el parámetro de salida MiniportDeviceContext de la función DxgkDdiAddDevice .
[in] pQueryAdapterInfo
Puntero a una estructura DXGKARG_QUERYADAPTERINFO que el KMD rellena con la información de configuración del adaptador de gráficos.
Valor devuelto
DxgkDdiQueryAdapterInfo devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | DxgkDdiQueryAdapterInfo recuperó correctamente la información de configuración. |
| STATUS_INVALID_PARAMETER | Los parámetros que se pasaron a DxgkDdiQueryAdapterInfo contenían errores que impedían que se completara. |
| STATUS_NO_MEMORY | DxgkDdiQueryAdapterInfo no pudo asignar memoria necesaria para que se completara. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | El controlador de minipuerto de pantalla para mostrar no es compatible con el controlador de pantalla en modo de usuario que inició la llamada a DxgkDdiQueryAdapterInfo (es decir, se proporcionan datos privados para una consulta al controlador de miniporte de pantalla). |
Comentarios
Cuando el controlador de pantalla en modo de usuario llama a la función pfnQueryAdapterInfoCb , se inicia una llamada a la función DxgkDdiQueryAdapterInfo .
Si DxgkDdiQueryAdapterInfo recibe el valor DXGKQAITYPE_UMDRIVERPRIVATE en el miembro Type de la estructura DXGKARG_QUERYADAPTERINFO a la que apunta el parámetro pQueryAdapterInfo , pOutputData apunta a una estructura propietaria que KMD rellena con la información de configuración necesaria para que el controlador de pantalla en modo de usuario identifique el adaptador.
Si Dxgkrnl especifica el valor DXGKQAITYPE_DRIVERCAPS en el miembro Type de DXGKARG_QUERYADAPTERINFO cuando el subsistema llama a DxgkDdiQueryAdapterInfo, el controlador de miniporte de pantalla debe rellenar la estructura de DXGK_DRIVERCAPS proporcionada con información que el subsistema puede usar.
Si el subsistema del kernel de gráficos de DirectX proporciona el valor DXGKQAITYPE_QUERYSEGMENT en el miembro Type de DXGKARG_QUERYADAPTERINFO, el controlador de miniporte de pantalla 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 que admiten WDDM 2.6 y versiones posteriores deben implementar la devolución de llamada DxgkDdiQueryAdapterInfo .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |