DXGKARG_COLLECTDIAGNOSTICINFO 구조체(dispmprt.h)

아티클
02/23/2024

DXGKDDI_COLLECTDIAGNOSTICINFO 콜백 함수에서 다양한 이유로 프라이빗 드라이버 정보를 수집하는 데 사용됩니다.

예를 들어 OS는 요청되는 정보 유형(DXGK_DIAGNOSTICINFO_TYPE)을 제공하면서 진단 정보가 필요할 때 DXGKDDI_COLLECTDIAGNOSTICINFO 콜백 함수를 호출합니다. 드라이버는 문제를 조사하고 OS에 제출하기 위해 모든 개인 정보를 수집해야 합니다.

구문

typedef struct _DXGKARG_COLLECTDIAGNOSTICINFO {
  [in, optional]  HANDLE                   hAdapter;
  [in]            DXGK_DIAGNOSTICINFO_TYPE Type;
                  CHAR                     BucketingString[DXGK_DUMP_BUCKETING_BUFFER_SIZE];
                  CHAR                     DescriptionString[DXGK_DUMP_DESCRIPTION_BUFFER_SIZE];
  union {
    [out, optional] PVOID pReserved;
  };
  [in]            UINT                     BufferSizeIn;
  [out]           UINT                     BufferSizeOut;
  [out]           PVOID                    pBuffer;
} DXGKARG_COLLECTDIAGNOSTICINFO;

멤버

[in, hAdapter

디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다.

WDDM 2.6 이전에는 디스플레이 미니포트 드라이버의 DxgkDdiAddDevice 함수가 DirectX 그래픽 커널 하위 시스템에 이 핸들을 제공했습니다. 이 매개 변수는 선택 사항이며 드라이버가 OS에 핸들을 제공하지 못한 경우 NULL일 수 있습니다.

[in] Type

드라이버에서 수집해야 하는 정보의 유형을 나타내는 DXGK_DIAGNOSTICINFO_TYPE 열거형 값입니다.

[out] BucketingString[DXGK_DUMP_BUCKETING_BUFFER_SIZE]

드라이버가 버킷팅을 위해 문제를 식별하는 데 사용해야 하는 문자열에 대해 제공되는 고정 크기 버퍼입니다. 이 문자열은 동일한 문제에 대해 드라이버 버전 간에 일치해야 하므로 원본 참조, 드라이버 버전 등의 요소를 포함하거나 펜스 번호 또는 대상 ID와 같은 특정 세부 정보를 instance 않아야 합니다. 실패한 내부 하위 구성 요소의 식별자 또는 모듈의 이름(예 mismatched_driver_ihvxseries.sys: )과 같은 정보가 포함될 수 있습니다. 유효한 코드는 이며 0x21-0x7E 공백() 대신 밑줄(0x5f0x20)을 사용해야 합니다.

[out, DescriptionString[DXGK_DUMP_DESCRIPTION_BUFFER_SIZE]

드라이버가 버킷팅에 사용되지 않지만 특정 문제에 대한 자세한 정보(예mismatched_driver_versions_kmd_10.22.1111.1121,_ihvxseries:10.22.1111.1122: )를 제공하는 데 사용할 수 있는 instance 특정 세부 정보를 설명하는 데 사용해야 하는 문자열에 대해 제공되는 고정 크기 버퍼입니다. 유효한 코드는 이며 0x21-0x7E 공백() 대신 밑줄(0x5f0x20)을 사용해야 합니다.

[out, pReserved

OS가 일부 형식에 대해 제공할 수 있는 형식별 인수에 대한 포인터의 자리 표시자로 예약된 명명되지 않은 공용 구조체의 VOID에 대한 포인터입니다. 이 값은 확장된 정보가 필요하지 않은 형식 의 경우 NULL입니다.

[in] BufferSizeIn

OS 할당 버퍼의 크기(바이트)를 제공하는 변수입니다. DXGK_DI_ADDDEVICE 및 DXGK_DI_STARTDEVICE형식 값의 경우 크기는 약 0x80000.

[out] BufferSizeOut

드라이버가 프라이빗 데이터로 채워진 실제 크기로 업데이트해야 하는 변수입니다. 프라이빗 데이터가 제공되지 않으면 드라이버는 변수에 0을 할당해야 합니다.

[out] pBuffer

프라이빗 드라이버 데이터를 수신하는 버퍼에 대한 포인터입니다.