структура D3DDDI_QUERYREGISTRY_FLAGS (d3dukmdt.h)

Статья
02/08/2025

Эти флаги определяют, как извлекаются строки через pfnQueryAdapterInfoCb2 для D3DDDI_QUERYADAPTERTYPE_QUERYREGISTRY.

Синтаксис

typedef struct _D3DDDI_QUERYREGISTRY_FLAGS {
  union {
    struct {
      UINT TranslatePath : 1;
      UINT MutableValue : 1;
      UINT Reserved : 30;
    };
    UINT Value;
  };
} D3DDDI_QUERYREGISTRY_FLAGS;

Члены

TranslatePath

TranslatePath предназначен для использования вызывающим оператором из виртуальной машины. Этот флаг игнорируется, если вызов выполняется из не виртуализированной среды. Дополнительные сведения см. в пара-виртуализации GPU.

Если определенный раздел реестра хранит путь к другому файлу драйвера, вызывающий объект pfnQueryAdapterInfoCb2 может перевести этот путь в путь, к которому могут получить доступ изолированные процессы. Параметр TranslatePath значение 1 указывает, что раздел реестра является строкой, которая должна быть преобразована при необходимости.

Если этот флаг задан, D3DDDI_QUERYREGISTRY_INFO::ValueType должен быть REG_SZ, REG_MULTI_SZили REG_EXPAND_SZ, а строка значений обрабатывается для преобразования пути к пространству виртуальной машины. Перевод происходит только в том случае, если OutputString является абсолютным путем к файлу в папке DriverStore. Путь преобразуется в <SystemDrive>:\windows\system32\HostDriverStore\....

Установите флаг, только если D3DDDI_QUERYREGISTRY_INFO::QueryTypeD3DDDI_QUERYREGISTRY_SERVICEKEY или D3DDDI_QUERYREGISTRY_ADAPTERKEY.

Строка реестра должна быть полным путем к файлу в хранилище драйверов. Перевод не возникает, если перевод не нужен.

значение TranslatePath должно иметь значение 0, если используется D3DDDI_QUERYREGISTRY_INFO::D 3DDDI_QUERYREGISTRY_DRIVERSTOREPATH и D3DDDI_QUERYREGISTRY_DRIVERIMAGEPATH. Однако D3DDDI_QUERYREGISTRY_DRIVERSTOREPATH и D3DDDI_QUERYREGISTRY_DRIVERIMAGEPATH всегда будут действовать так, как если бы TranslatePath было установлено значение 1.

MutableValue

Скрытный. Вызывающие pfnQueryAdapterInfoCb2 должны иметь значение 0.

Reserved

Скрытный. Вызывающие pfnQueryAdapterInfoCb2 должны иметь значение 0.

Ценность

Поле значение существует для чтения всех этих флагов в необработанном синтаксисе вместо именованного битового поля.

Value

Требования

Требование	Ценность
Минимально поддерживаемый клиент	Windows 10 версии 1803 (WDDM 2.4)
заголовка	d3dukmdt.h

См. также

D3DDDI_QUERYREGISTRY_INFO

D3DKMTQueryAdapterInfo

Поделиться через