estrutura QUERY_INTERFACE (video.h)

Artigo
01/16/2025

A estrutura QUERY_INTERFACE descreve a interface que está sendo solicitada.

Sintaxe

typedef struct _QUERY_INTERFACE {
  const GUID *InterfaceType;
  USHORT     Size;
  USHORT     Version;
  PINTERFACE Interface;
  PVOID      InterfaceSpecificData;
  ULONG      DeviceUid;
} QUERY_INTERFACE, *PQUERY_INTERFACE;

Membros

InterfaceType

Ponteiro para um GUID que identifica a interface que está sendo solicitada. Se o KMD (driver de miniporto de exibição) do modo kernel (ou driver de miniporto de vídeo herdado) não oferecer suporte aointerfaceType especificado, ele deverá falhar na chamada e retornar imediatamente.

O pai gera esse GUID com uuidgen.exe. Consulte Definindo e exportando novos GUIDs para obter detalhes.

Size

Especifica o tamanho em bytes da estrutura de interface de à qual interface pontos. O driver não deve retornar uma estrutura de de INTERFACE maior que Tamanho bytes.

Version

Especifica a versão da interface que está sendo solicitada.

Se um pai der suporte a mais de uma versão de uma interface, seu driver deverá retornar a versão especificada ou, se possível, a versão com suporte mais próxima sem exceder a versão solicitada. O chamador é responsável por examinar a versão retornada e determinar o que fazer com base nesse valor.

Interface

Ponteiro para uma estrutura interface do na qual o driver retorna as informações de interface solicitadas. O chamador é responsável por alocar essa estrutura antes de chamar DxgkddiQueryInterface (ou HwVidQueryInterface).

InterfaceSpecificData

Especifica informações adicionais sobre a interface que está sendo solicitada. Normalmente, esse membro é NULL e os membros InterfaceType e Version são suficientes para o pai identificar a interface que está sendo solicitada.

DeviceUid

Um inteiro positivo que identifica o dispositivo para o qual a interface está sendo consultada. Se DeviceUid for igual a DISPLAY_ADAPTER_HW_ID (definido em Video.h), o dispositivo será o próprio adaptador de exibição. Caso contrário, DeviceUid é o identificador de um dispositivo filho do adaptador de exibição. Os identificadores de dispositivo filho foram atribuídos anteriormente pela função DxgkDdiQueryChildRelations. Disponível a partir do Windows 8.1 (WDDM 1.3).

Observações

O parâmetro QueryInterface do DxgkddiQueryInterface do KMD retorno de chamada (ou driver de miniporto de vídeo herdadofunção HwVidQueryInterface) é um ponteiro para uma estrutura QUERY_INTERFACE.

Requisitos

Requisito	Valor
cabeçalho	video.h (inclua Video.h)

Consulte também

DxgkddiQueryInterface

HwVidQueryInterface

Partilhar via