Rediger

Del via


D3DDDI_QUERYREGISTRY_FLAGS structure (d3dukmdt.h)

These flags control how strings are being retrieved through pfnQueryAdapterInfoCb2 for D3DDDI_QUERYADAPTERTYPE_QUERYREGISTRY.

Syntax

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

Members

TranslatePath

TranslatePath is meant for use by the caller from a virtual machine. This flag is ignored if a call is made from a non-virtualized environment. For more information, see GPU para-virtualization.

When a particular registry key stores a path to another driver file, the caller of pfnQueryAdapterInfoCb2 might have that path translated into the path that an isolated processes can access. Setting TranslatePath to 1 indicates the registry key is a string that should be translated, when appropriate.

When this flag is set, D3DDDI_QUERYREGISTRY_INFO::ValueType must be REG_SZ, REG_MULTI_SZ, or REG_EXPAND_SZ and the value string is processed to translate the path to the virtual machine space. The translation only happens when the OutputString is an absolute path to a file in the DriverStore folder. The path is translated to <SystemDrive>:\windows\system32\HostDriverStore\....

Set the flag only when D3DDDI_QUERYREGISTRY_INFO::QueryType is D3DDDI_QUERYREGISTRY_SERVICEKEY or D3DDDI_QUERYREGISTRY_ADAPTERKEY.

The registry string must be a full path to a file in the driver store. Translation won't occur when translation isn't needed.

TranslatePath must be set to 0 when D3DDDI_QUERYREGISTRY_INFO::D3DDDI_QUERYREGISTRY_DRIVERSTOREPATH and D3DDDI_QUERYREGISTRY_DRIVERIMAGEPATH are used. However, D3DDDI_QUERYREGISTRY_DRIVERSTOREPATH and D3DDDI_QUERYREGISTRY_DRIVERIMAGEPATH will always act as if TranslatePath were set to 1.

MutableValue

Reserved. Callers of pfnQueryAdapterInfoCb2 must set this value to 0.

Reserved

Reserved. Callers of pfnQueryAdapterInfoCb2 must set this value to 0.

Value

The Value field exists to read all these flags in a raw syntax, instead of the named bitfield.

Value

Requirements

Requirement Value
Minimum supported client Windows 10, version 1803 (WDDM 2.4)
Header d3dukmdt.h

See also

D3DDDI_QUERYREGISTRY_INFO

D3DKMTQueryAdapterInfo