D3DDDI_QUERYREGISTRY_INFO 구조체(d3dukmdt.h)

아티클
02/26/2024

D3DDDI_QUERYREGISTRY_INFO 구조는 D3DKMT_QUERYADAPTERINFO::Type이 KMTQAITYPE_QUERYREGISTRY 때 D3DKMT_QUERYADAPTERINFO::pDriverPrivateData를 재해석하는 방법을 나타냅니다.

구문

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;

멤버

QueryType

[in] 검색할 데이터를 나타내는 D3DDDI_QUERYREGISTRY_TYPE 값입니다.

QueryType 은 가장 중요한 필드입니다. 레지스트리 또는 파일 경로가 검색되고 있는지 여부와 특정 레지스트리 하이브 및 파일 경로를 나타냅니다.

레지스트리 키 열거형:

D3DDDI_QUERYREGISTRY_SERVICEKEY
D3DDDI_QUERYREGISTRY_ADAPTERKEY

파일 경로 열거형:

D3DDDI_QUERYREGISTRY_DRIVERSTOREPATH
D3DDDI_QUERYREGISTRY_DRIVERIMAGEPATH

QueryFlags

[in] 문자열을 검색하는 방법을 제어하는 플래그가 있는 D3DDDI_QUERYREGISTRY_FLAGS 구조체입니다. QueryFlags는 파일 경로가 포함된 검색된 문자열을 게스트 환경으로 변환하는 등의 추가 작업을 수행할 수 있습니다.

ValueName[MAX_PATH]

[in] 레지스트리 정보를 검색할 때 ValueName 은 검색할 레지스트리 값 이름을 지정해야 합니다. 파일 경로 정보를 검색할 때 ValueName 은 무시됩니다.

ValueType

[in] 레지스트리 정보를 검색할 때 ValueType 은 레지스트리 값 이름에 해당하는 예상 레지스트리 값 형식을 지정해야 합니다. 파일 경로 정보를 검색할 때 성공하려면 ValueType 이 0이어야 합니다. 자세한 내용은 레지스트리 값 형식 을 참조하세요.

PhysicalAdapterIndex

[in] LDA 체인의 실제 어댑터 인덱스입니다.

OutputValueSize

[out] 출력 데이터의 크기는 해당 데이터를 검색할 공간이 충분하지 않은 경우에도 이 필드로 검색됩니다. 이 필드는 변수 크기의 데이터를 검색할 때 가장 유용합니다.

Status

[out] 쿼리의 상태 나타내는 D3DDDI_QUERYREGISTRY_STATUS 값입니다.

쿼리의 상태 다양한 양의 데이터가 검색되었음을 나타내기 위해 별도로 반환됩니다. 다음 세 가지 반환 상태를 이해하는 것이 가장 중요합니다.

QueryAdapterInfo가 STATUS_SUCCESS 반환하고 상태가D3DDDI_QUERYREGISTRY_STATUS_SUCCESS 경우 출력 으로 시작하는 모든 필드가 유효합니다.
QueryAdapterInfo가 STATUS_SUCCESS 반환하고 상태가D3DDDI_QUERYREGISTRY_STATUS_BUFFER_OVERFLOW 경우 OutputValueSize 만 유효합니다.
QueryAdapterInfo가 STATUS_SUCCESS 반환하지 않으면 상태가 D3DDDI_QUERYREGISTRY_STATUS_FAIL 변경될 수 있다는 점을 제외하고 모든 필드는 수정되지 않은 상태로 유지됩니다.

OutputDword

[out] 성공적으로 검색된 데이터를 재해석하기 위한 편리한 필드입니다. 레지스트리 DWORD를 읽을 때 가장 유용합니다.

OutputQword

[out] 성공적으로 검색된 데이터를 재해석하기 위한 편리한 필드입니다. 레지스트리 QWORD를 읽을 때 가장 유용합니다.

OutputString[1]

OutputBinary[1]