DXGKARG_COLLECTDIAGNOSTICINFO 구조체(dispmprt.h)

아티클
02/06/2025

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와 같은 인스턴스별 세부 정보와 같은 요소가 포함되어서는 안 됩니다. 실패한 내부 하위 구성 요소의 식별자 또는 모듈 이름(예: mismatched_driver_ihvxseries.sys)과 같은 정보가 포함될 수 있습니다. 유효한 코드는 0x21-0x7E 공간(0x20) 대신 밑줄(0x5f)을 사용해야 합니다.

[out, DescriptionString[DXGK_DUMP_DESCRIPTION_BUFFER_SIZE]

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

[out, pReserved

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

[in] BufferSizeIn

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

[out] BufferSizeOut

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

[out] pBuffer

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