WheaAddErrorSourceDeviceDriver 함수(ntddk.h)
디바이스 드라이버가 WheaAddErrorSourceDeviceDriver 를 호출하여 오류 원본을 추가합니다.
구문
NTSTATUS WheaAddErrorSourceDeviceDriver(
PVOID Context,
PWHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER Configuration,
ULONG NumberPreallocatedErrorReports
);
매개 변수
Context
호출자가 할당한 컨텍스트에 대한 선택적 포인터입니다. WHEA는 드라이버 제공 콜백 루틴에 대한 매개 변수로 컨텍스트를 제공합니다. NULL일 수 있습니다.
Configuration
드라이버 제공 콜백 루틴 집합을 포함하는 형식 WHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER 구조체에 대한 포인터입니다.
NumberPreallocatedErrorReports
미리 할당할 레코드 수를 지정하는 ULONG 형식의 값입니다. 자세한 내용은 설명 부분을 참조하십시오.
반환 값
이 함수 메서드는 오류 원본이 추가되면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 다음 중 하나를 반환할 수 있습니다.
- STATUS_INVALID_PARAMETER: 구성에 콜백 포인터 초기화 및/또는 초기화 해제가 없습니다.
- STATUS_INVALID_PARAMETER_2: 잘못된 버전이 있는 구성이 제출되었습니다.
- STATUS_INSUFFICIENT_RESOURCES: WHEA에서 오류 원본 및 해당 레코드에 대한 공간을 할당할 수 없습니다.
설명
오류 원본을 제거하기 위해 드라이버는 WheaRemoveErrorSourceDeviceDriver를 호출합니다.
WHEA는 높은 IRQL(즉, 디바이스 인터럽트 컨텍스트)에서 보고되는 오류에 대한 메모리를 미리 할당할 수 있습니다. PASSIVE_LEVEL 보고된 오류 원본의 경우 사전 할당이 필요하지 않지만 디바이스 드라이버가 DISPATCH_LEVEL 이상의 오류 원본에 대한 오류를 보고하는 경우 오류 레코드를 미리 할당해야 합니다.
자세한 내용은 Windows 10 WHEA 사용을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10, 버전 2004 |
| 머리글 | ntddk.h |