WheaFindErrorRecordSection 函式 (ntddk.h)
WheaFindErrorRecordSection 函式會在 WHEA 錯誤記錄內搜尋指定的 Windows 硬體錯誤架構 (WHEA) 錯誤記錄區段。 錯誤記錄區段的格式為 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
GUID，指定要位於指定 WHEA 錯誤記錄內的WHEA_ERROR_RECORD_SECTION_DESCRIPTOR結構。
[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 代碼：
| 傳回碼 | Description |
|---|---|
| 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 |