estrutura D3DDDI_QUERYREGISTRY_INFO (d3dukmdt.h)

Artigo
10/11/2023

A estrutura D3DDDI_QUERYREGISTRY_INFO indica como D3DKMT_QUERYADAPTERINFO::p DriverPrivateData deve ser reinterpretado quando D3DKMT_QUERYADAPTERINFO::Type é KMTQAITYPE_QUERYREGISTRY.

Sintaxe

typedef struct _D3DDDI_QUERYREGISTRY_INFO {
  D3DDDI_QUERYREGISTRY_TYPE   QueryType;
  D3DDDI_QUERYREGISTRY_FLAGS  QueryFlags;
  WCHAR                       ValueName[MAX_PATH];
  ULONG                       ValueType;
  ULONG                       PhysicalAdapterIndex;
  ULONG                       OutputValueSize;
  D3DDDI_QUERYREGISTRY_STATUS Status;
  union {
    DWORD                 OutputDword;
    D3DKMT_ALIGN64 UINT64 OutputQword;
    WCHAR                 OutputString[1];
    BYTE                  OutputBinary[1];
  };
} D3DDDI_QUERYREGISTRY_INFO;

Membros

QueryType

[in] Um valor D3DDDI_QUERYREGISTRY_TYPE que indica quais dados recuperar.

QueryType é o campo mais significativo. Indica se os caminhos do registro ou do arquivo estão sendo recuperados, bem como qual hive de registro específico e caminho de arquivo.

Enumerações de chave do Registro:

D3DDDI_QUERYREGISTRY_SERVICEKEY
D3DDDI_QUERYREGISTRY_ADAPTERKEY

Enumerações de caminho de arquivo:

D3DDDI_QUERYREGISTRY_DRIVERSTOREPATH
D3DDDI_QUERYREGISTRY_DRIVERIMAGEPATH

QueryFlags

[in] Uma estrutura D3DDDI_QUERYREGISTRY_FLAGS com sinalizadores que controlam como as cadeias de caracteres são recuperadas. QueryFlags pode fazer operações adicionais, como traduzir cadeias de caracteres recuperadas que contêm caminhos de arquivo para o ambiente convidado.

ValueName[MAX_PATH]

[in] Ao recuperar informações do Registro, ValueName deve especificar o nome do valor do Registro a ser recuperado. Ao recuperar informações do caminho do arquivo, ValueName é ignorado.

ValueType

[in] Ao recuperar informações do Registro, ValueType deve especificar o tipo de valor esperado do Registro que corresponde ao nome do valor do Registro. Ao recuperar informações do caminho do arquivo, ValueType deve ser 0 para ter êxito. Consulte Tipos de valor do Registro para obter mais detalhes.

PhysicalAdapterIndex

[in] O índice do adaptador físico em uma cadeia LDA.

OutputValueSize

[out] O tamanho dos dados de saída é recuperado para esse campo, mesmo quando não havia espaço suficiente para recuperar esses dados. Esse campo é mais útil quando dados de tamanho variável estão sendo recuperados.

Status

[out] Um valor D3DDDI_QUERYREGISTRY_STATUS que indica o status da consulta.

O status da consulta é retornado separadamente para indicar que diferentes quantidades de dados foram recuperadas. Os três estados de retorno a seguir são mais importantes para entender:

Quando QueryAdapterInfo retorna STATUS_SUCCESS e Status é D3DDDI_QUERYREGISTRY_STATUS_SUCCESS, todos os campos que começam com Saída são válidos.
Quando QueryAdapterInfo retorna STATUS_SUCCESS e Status é D3DDDI_QUERYREGISTRY_STATUS_BUFFER_OVERFLOW, somente OutputValueSize é válido.
Quando QueryAdapterInfo não retorna STATUS_SUCCESS, todos os campos são deixados não modificados, exceto status pode ser alterado para D3DDDI_QUERYREGISTRY_STATUS_FAIL.

OutputDword

[out] Um campo de conveniência para reinterpretar os dados recuperados com êxito. É mais útil quando um DWORD do Registro está sendo lido.

OutputQword

[out] Um campo de conveniência para reinterpretar os dados recuperados com êxito. É mais útil quando um QWORD do Registro está sendo lido.

OutputString[1]

OutputBinary[1]

Comentários

D3DDDI_QUERYREGISTRY_INFO é usado para ler o registro para obter informações que normalmente são armazenadas em cache durante a instalação do driver.

Em vez de usar métodos brutos do sistema operacional, os drivers de modo de usuário e outros componentes devem usar essa técnica onipresentemente nas versões do sistema operacional em que há suporte. Isso permite que o sistema operacional maximize a compatibilidade do modo de usuário com alterações de dependência e cenários como ambientes virtualizados.