DXGKDDI_QUERYADAPTERINFO función de devolución de llamada (d3dkmddi.h)

La función DxgkDdiQueryAdapterInfo recupera 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 controlador de miniporte de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de Microsoft DirectX en el parámetro de salida MiniportDeviceContext de la función DxgkDdiAddDevice .

[in] pQueryAdapterInfo

Puntero a una estructura DXGKARG_QUERYADAPTERINFO que el controlador de miniporte de pantalla 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 complete.
STATUS_GRAPHICS_DRIVER_MISMATCH	El controlador de miniporte de pantalla de pantalla 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 minipuerto 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 . DxgkDdiQueryAdapterInfo recibe el valor de DXGKQAITYPE_UMDRIVERPRIVATE en el miembro Type de la estructura DXGKARG_QUERYADAPTERINFO a la que apunta el parámetro pQueryAdapterInfo . Esta función también recibe un búfer propietario en el miembro pOutputData que rellena con la información de configuración necesaria para que el controlador de pantalla en modo de usuario identifique el adaptador.

Si el subsistema de kernel de gráficos de DirectX (que forma parte de Dxgkrnl.sys) especifica el valor de 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 puede usar el subsistema.

Si el subsistema del kernel de gráficos de DirectX proporciona el valor de 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.

Nota

Todos los controladores que admiten WDDM 2.6 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

Consulte también

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb