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

Consulte también

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb