WheaReportHwErrorDeviceDriver 함수(ntddk.h)

하드웨어 오류를 보고하기 위해 드라이버는 WheaReportHwErrorDeviceDriver 함수를 호출합니다.

구문

NTSTATUS WheaReportHwErrorDeviceDriver(
  ULONG               ErrorSourceId,
  PDEVICE_OBJECT      DeviceObject,
  PUCHAR              ErrorData,
  ULONG               ErrorDataLength,
  LPGUID              SectionTypeGuid,
  WHEA_ERROR_SEVERITY ErrorSeverity,
  LPSTR               DeviceFriendlyName
);

매개 변수

ErrorSourceId

_WHEA_ERROR_SOURCE_INITIALIZE_DEVICE_DRIVER 콜백을 호출할 때 제공된 오류 원본 ID WHEA입니다.

DeviceObject

오류 조건과 연결된 디바이스 개체에 대한 포인터입니다.

ErrorData

드라이버의 하드웨어 오류 데이터가 포함된 버퍼입니다. 이 정보는 하드웨어에 따라 다릅니다. 드라이버가 WheaAddErrorSourceDeviceDriver 에 제공한 MaxRawDataLength를 초과해서는 안됩니다.

ErrorDataLength

오류 데이터의 크기(바이트)를 지정하는 ULONG 형식의 값입니다.

SectionTypeGuid

보고되는 오류 데이터의 유형을 지정합니다. UEFI 사양의 부록 N에 정의된 GUID 중 하나일 수 있지만 필요하지는 않습니다. 이 경우 오류 정보가 지정된 섹션 형식 중 하나와 일치합니다. 호출자는 GUID 및 프라이빗 섹션 형식을 만들 수도 있습니다.

ErrorSeverity

오류 조건의 심각도를 지정하는 WHEA_ERROR_SEVERITY 형식의 열거형 값입니다.

DeviceFriendlyName

오류 조건과 연결된 디바이스를 설명하는 최대 20바이트 길이의 선택적 문자열(NULL 종결자 포함)입니다. 이 정보는 결과 WHEA 오류 레코드에 복사되며 정보 전용입니다. 이 정보는 이벤트 로그를 만들 때 소비자가 디바이스 문제를 쉽게 해결할 수 있도록 오류 레코드에 배치하는 것입니다.

반환 값

이 함수 메서드는 STATUS_SUCCESS 또는 적절한 오류 코드를 반환합니다.

요구 사항

추가 정보

WheaAddErrorSourceDeviceDriver

WheaRemoveErrorSourceDeviceDriver