DXGKDDI_COLLECTDIAGNOSTICINFO 콜백 함수(dispmprt.h)

DxgkDdiCollectDiagnosticInfo 콜백 루틴은 DXGK_DIAGNOSTICINFO_TYPE지정된 이유로 프라이빗 드라이버 정보를 수집합니다.

Windows 10 버전 1903에서는 함수가 DxgkDdiAddDevice 호출하거나 DxgkDdiStartDevice 실패한 경우 드라이버가 개인 정보를 수집하도록 호출됩니다.

통사론

DXGKDDI_COLLECTDIAGNOSTICINFO DxgkddiCollectdiagnosticinfo;

NTSTATUS DxgkddiCollectdiagnosticinfo(
  [in]      IN_CONST_PDEVICE_OBJECT PhysicalDeviceObject,
  [in, out] INOUT_PDXGKARG_COLLECTDIAGNOSTICINFO pCollectDiagnosticInfo
)
{...}

매개 변수

[in] PhysicalDeviceObject

디스플레이 어댑터를 식별하는 PDO(물리적 디바이스 개체)에 대한 포인터입니다.

[in, out] pCollectDiagnosticInfo

드라이버에서 수집한 정보를 설명하는 DXGKARG_COLLECTDIAGNOSTICINFO 구조체에 대한 포인터입니다.

반환 값

개인 데이터 정보가 성공적으로 수집되었는지 STATUS_SUCCESS 반환합니다. 그렇지 않으면 다음 중 하나와 같은 오류 코드를 반환합니다.

발언

이 함수는 DxgkDdiAddDevice 및 DxgkDdiStartDevice호출 사이에 언제든지 PASSIVE 수준에서 호출되며 동기화 0 수준지원해야 합니다. 수집된 데이터에는 개인 사용자 정보가 포함되어서는 안 됩니다.

WDDM 2.7 이상 드라이버는 블랙 스크린 블랙 박스 데이터 수집에 대한 DXGK_DI_BLACKSCREENDXGK_DIAGNOSTICINFO_TYPE 열거형 유형을 지원해야 합니다.

검은색 화면 시나리오의 경우 OS는 먼저 DxgkDdiGetDisplayStateNonIntrusive 호출하고 이 DDI를 호출하기 전에 DxgkDdiGetDisplayStateIntrusive 드라이버에서 화이트 박스 데이터를 수집합니다.

pCollectDiagnosticInfo->BucketingString 사용하여 가능한 경우 블랙박스 데이터를 버킷팅하는 것이 좋습니다. BufferSizeIn 입력 버퍼의 크기가 모든 블랙 박스 데이터에 충분하지 않은 경우 드라이버는 대부분의 검은색 화면 근본 원인 분석에서 가장 중요하지 않은 데이터를 제외하는 데 있어 자체적인 절충을 수행해야 합니다.

요구 사항

참고 항목

DXGKARG_COLLECTDIAGNOSTICINFO

DxgkDdiAddDevice

DxgkDdiStartDevice