WheaFindErrorRecordSection 함수(ntddk.h)
WheaFindErrorRecordSection 함수는 WHEA 오류 레코드 내에서 지정된 WHEA(Windows 하드웨어 오류 아키텍처) 오류 레코드 섹션을 검색합니다. 오류 레코드 섹션의 형식은 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 구조체로 지정됩니다.
구문
NTSTATUS WheaFindErrorRecordSection(
[in] PWHEA_ERROR_RECORD Record,
[in] const GUID *SectionType,
[out] PWHEA_ERROR_RECORD_SECTION_DESCRIPTOR *SectionDescriptor,
[out, optional] PVOID *SectionData
);
매개 변수
[in] Record
WHEA_ERROR_RECORD 구조체로 형식이 지정된 WHEA 오류 레코드에 대한 포인터입니다.
[in] SectionType
지정된 WHEA 오류 레코드 내에 배치할 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 구조를 지정하는 GUID입니다.
[out] SectionDescriptor
WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 포인터의 주소입니다.
WheaFindErrorRecordSection 함수가 지정된 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 구조를 찾는 경우 이 함수는 SectionDescriptor 매개 변수를 지정된 WHEA 오류 레코드 내의 해당 구조체 주소로 설정합니다.
[out, optional] SectionData
PVOID 포인터의 주소입니다.
WheaFindErrorRecordSection 함수가 지정된 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 구조를 찾는 경우 이 함수는 SectionData 매개 변수를 지정된 WHEA 오류 레코드 내에서 해당 설명자와 연결된 하드웨어 오류 데이터의 주소로 설정합니다.
이 매개 변수는 선택 사항이며 하드웨어 오류 데이터에 대한 포인터가 필요하지 않은 경우 NULL 로 설정해야 합니다.
반환 값
WheaFindErrorRecordSection 은 다음 NTSTATUS 코드 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_SUCCESS | 지정된 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 구조체가 발견되었습니다. |
| STATUS_NOT_FOUND | 지정된 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 구조체를 찾을 수 없습니다. |
| STATUS_INVALID_PARAMETER | Record, SectionType 또는 SectionDescriptor 매개 변수가 NULL로 설정되었거나 Record 매개 변수를 통해 참조된 WHEA 오류 레코드가 잘못되었습니다. |
설명
WheaFindErrorRecordSection이 STATUS_SUCCESS 반환하는 경우 Guid 매개 변수를 통해 지정된 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 구조체를 찾습니다. WheaFindErrorRecordSection 은 SectionDescriptor 매개 변수를 배치된 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 구조체의 주소로 설정합니다.
또한 WheaFindErrorRecordSection 이 STATUS_SUCCESS 반환하고 호출자가 SectionData 매개 변수를 PVOID 포인터 변수의 주소로 설정하면 함수는 지정된 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 구조체와 연결된 하드웨어 오류 데이터의 주소로 매개 변수를 업데이트합니다.
하드웨어 오류 데이터의 형식은 SectionDescriptor 매개 변수를 통해 참조되는 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 구조체의 SectionType 멤버에 따라 달라집니다. 예를 들어 SectionType 멤버에 PROCESSOR_GENERIC_ERROR_SECTION_GUID 값이 있는 경우 하드웨어 오류 데이터의 형식은 WHEA_PROCESSOR_GENERIC_ERROR_SECTION 구조체로 지정됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 이상 버전의 Windows에서 지원됩니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | ntddk.h(Ntddk.h 포함) |
| IRQL | IRQL <=DISPATCH_LEVEL |