estructura D3DDDI_QUERYREGISTRY_INFO (d3dukmdt.h)

Artículo
02/23/2024

La estructura D3DDDI_QUERYREGISTRY_INFO indica cómo se debe reinterpretar D3DKMT_QUERYADAPTERINFO::p DriverPrivateData cuando se KMTQAITYPE_QUERYREGISTRYD3DKMT_QUERYADAPTERINFO::Type.

Sintaxis

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;

Miembros

QueryType

[in] Valor D3DDDI_QUERYREGISTRY_TYPE que indica qué datos se van a recuperar.

QueryType es el campo más significativo. Indica si se recuperan las rutas de acceso del registro o del archivo, así como la ruta de acceso de archivo y el subárbol del Registro específicos.

Enumeraciones de clave del Registro:

D3DDDI_QUERYREGISTRY_SERVICEKEY
D3DDDI_QUERYREGISTRY_ADAPTERKEY

Enumeraciones de ruta de acceso de archivo:

D3DDDI_QUERYREGISTRY_DRIVERSTOREPATH
D3DDDI_QUERYREGISTRY_DRIVERIMAGEPATH

QueryFlags

[in] Estructura D3DDDI_QUERYREGISTRY_FLAGS con marcas que controlan cómo se recuperan las cadenas. QueryFlags puede realizar operaciones adicionales, como traducir cadenas recuperadas que contienen rutas de acceso de archivo al entorno invitado.

ValueName[MAX_PATH]

[in] Al recuperar información del Registro, ValueName debe especificar el nombre del valor del Registro que se va a recuperar. Al recuperar información de ruta de acceso de archivo, ValueName se omite.

ValueType

[in] Al recuperar información del Registro, ValueType debe especificar el tipo de valor del Registro esperado que corresponde al nombre del valor del Registro. Al recuperar información de ruta de acceso de archivo, ValueType debe ser 0 para que se realice correctamente. Consulte Tipos de valor del Registro para obtener más detalles.

PhysicalAdapterIndex

[in] Índice del adaptador físico en una cadena LDA.

OutputValueSize

[out] El tamaño de los datos de salida se recupera en este campo, incluso cuando no había espacio suficiente para recuperar esos datos. Este campo es más útil cuando se recuperan datos de tamaño variable.

Status

[out] Valor de D3DDDI_QUERYREGISTRY_STATUS que indica el estado de la consulta.

El estado de la consulta se devuelve por separado para indicar que se han recuperado cantidades variables de datos. Los tres estados devueltos siguientes son más importantes para comprender:

Cuando QueryAdapterInfo devuelve STATUS_SUCCESS y Status es D3DDDI_QUERYREGISTRY_STATUS_SUCCESS, todos los campos que comienzan por Output son válidos.
Cuando QueryAdapterInfo devuelve STATUS_SUCCESS y Status es D3DDDI_QUERYREGISTRY_STATUS_BUFFER_OVERFLOW, solo OutputValueSize es válido.
Cuando QueryAdapterInfo no devuelve STATUS_SUCCESS, todos los campos se dejan sin modificar, excepto que status puede cambiarse a D3DDDI_QUERYREGISTRY_STATUS_FAIL.

OutputDword

[out] Un campo de conveniencia para reinterpretar los datos recuperados correctamente. Resulta más útil cuando se lee un DWORD del Registro.

OutputQword

[out] Un campo de conveniencia para reinterpretar los datos recuperados correctamente. Resulta más útil cuando se lee un QWORD del Registro.

OutputString[1]

OutputBinary[1]

Comentarios

D3DDDI_QUERYREGISTRY_INFO se usa para leer el Registro para obtener información que se almacena normalmente en caché durante la instalación del controlador.

En lugar de usar métodos de so sin procesar, los controladores de modo de usuario y otros componentes deben usar esta técnica en las versiones del sistema operativo en las que se admite. Esto permite al sistema operativo maximizar la compatibilidad del modo de usuario con cambios de dependencia y escenarios como entornos virtualizados.