DXGKDDI_QUERY_INTERFACE função de retorno de chamada (dispmprt.h)

Artigo
05/23/2024

A função DxgkDdiQueryInterface retorna uma interface funcional implementada pelo driver de miniporto de exibição.

Sintaxe

DXGKDDI_QUERY_INTERFACE DxgkddiQueryInterface;

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

Parâmetros

[in] MiniportDeviceContext

Um identificador para um bloco de contexto associado a um adaptador de exibição. A função DxgkDdiAddDevice do driver de miniport de exibição forneceu anteriormente esse identificador para Dxgkrnl.

[in] QueryInterface

Um ponteiro para uma estrutura QUERY_INTERFACE na qual o driver de miniporto de exibição deve retornar informações sobre a interface compatível.

Retornar valor

DxgkDdiQueryInterface retornará STATUS_SUCCESS se for bem-sucedido; caso contrário, ele retorna um código NTSTATUS apropriado. Se um driver de miniporto de exibição não der suporte à interface solicitada, ele deverá retornar STATUS_NOT_SUPPORTED. Ao retornar STATUS_NOT_SUPPORTED, o driver de miniporto de exibição informa o sistema operacional para passar a consulta para o próximo driver.

Comentários

DxgkDdiQueryInterface expõe um mecanismo de comunicação entre o driver de miniporto de exibição e o driver de um dispositivo filho (por exemplo, um dispositivo de captura de vídeo). Um driver de miniporte de exibição que expõe esse mecanismo deve implementar essa função.

DxgkDdiQueryInterface deve preencher os membros da estrutura interface para a qual QueryInterface-Interface> aponta da seguinte maneira:

Defina Tamanho como o número de bytes na estrutura interface. Esse valor não deve exceder o número de bytes especificados por QueryInterface-Size>.
Defina Versão como a versão da interface que está sendo retornada pelo driver de miniporto de exibição. O driver de miniporto de exibição deve corresponder melhor à versão solicitada pelo driver filho em QueryInterface-Version>.
Defina Contexto para apontar para um contexto definido pelo driver de miniporto de exibição para a interface. Normalmente, um driver de miniporto de exibição definiria Context como o identificador para o bloco de contexto do adaptador de exibição identificado por MiniportDeviceContext.
Inicialize InterfaceReference e InterfaceDereference para apontar para as rotinas de referência e desreferência implementadas pelo driver de miniport de exibição para essa interface.
Inicialize todos os membros adicionais específicos da interface para apontar para as rotinas apropriadas da interface que está sendo exposta.