DXGKDDI_QUERY_INTERFACE función de devolución de llamada (dispmprt.h)

Artículo
05/23/2024

La función DxgkDdiQueryInterface devuelve una interfaz funcional implementada por el controlador de minipuerto de pantalla.

Sintaxis

DXGKDDI_QUERY_INTERFACE DxgkddiQueryInterface;

NTSTATUS DxgkddiQueryInterface(
  [in] IN_CONST_PVOID MiniportDeviceContext,
  [in] IN_PQUERY_INTERFACE QueryInterface
)
{...}

Parámetros

[in] MiniportDeviceContext

Identificador de un bloque de contexto asociado a un adaptador de pantalla. La función DxgkDdiAddDevice del controlador de minipuerto de pantalla proporcionó anteriormente este identificador a Dxgkrnl.

[in] QueryInterface

Puntero a una estructura QUERY_INTERFACE en la que el controlador de minipuerto de pantalla debe devolver información sobre la interfaz que admite.

Valor devuelto

DxgkDdiQueryInterface devuelve STATUS_SUCCESS si se realiza correctamente; de lo contrario, devuelve un código NTSTATUS adecuado. Si un controlador de minipuerto de pantalla no admite la interfaz solicitada, debe devolver STATUS_NOT_SUPPORTED. Al devolver STATUS_NOT_SUPPORTED, el controlador de minipuerto de pantalla informa al sistema operativo de pasar la consulta al controlador siguiente.

Comentarios

DxgkDdiQueryInterface expone un mecanismo de comunicación entre el controlador de minipuerto de pantalla y el controlador de un dispositivo secundario (por ejemplo, un dispositivo de captura de vídeo). Un controlador de minipuerto de pantalla que expone este mecanismo debe implementar esta función.

DxgkDdiQueryInterface debe rellenar los miembros de la estructura INTERFACE a la que QueryInterface-Interface> apunta de la siguiente manera:

Establezca Tamaño en el número de bytes de la estructura INTERFACE. Este valor no debe superar el número de bytes especificados por QueryInterface-Size>.
Establezca Versión en la versión de la interfaz devuelta por el controlador de minipuerto de pantalla. El controlador de minipuerto de pantalla debe coincidir mejor con la versión solicitada por el controlador secundario en QueryInterface-Version>.
Establezca Contexto para que apunte a un contexto definido por el controlador de minipuerto para la interfaz. Normalmente, un controlador de minipuerto de pantalla establecería Context en el identificador en el bloque de contexto del adaptador de pantalla identificado por MiniportDeviceContext.
Inicialice InterfaceReference e InterfaceDereference para que apunte a las rutinas de referencia y desreferencia implementadas por el controlador de miniporte de pantalla para esta interfaz.
Inicialice todos los miembros adicionales específicos de la interfaz para que apunten a las rutinas adecuadas de la interfaz que se exponen.