WheaFindNextErrorRecordSection 函式 (ntddk.h)

WheaFindNextErrorRecordSection 函式可讓呼叫者反覆檢查 WHEA 錯誤記錄中的 WHEA 錯誤記錄區段。 每個錯誤記錄區段都會格式化為 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 結構。

語法

NTSTATUS WheaFindNextErrorRecordSection(
  [in]            PWHEA_ERROR_RECORD                    Record,
  [in, out]       ULONG                                 *Context,
  [out]           PWHEA_ERROR_RECORD_SECTION_DESCRIPTOR *SectionDescriptor,
  [out, optional] PVOID                                 *SectionData
);

參數

[in] Record

格式化為 WHEA_ERROR_RECORD 結構的 WHEA 錯誤記錄指標。

[in, out] Context

ULONG 變數的指標，可維護搜尋的目前狀態。

此變數必須在第一次呼叫 WheaFindNextErrorRecordSection 函式之前初始化為零。

[out] SectionDescriptor

WHEA_ERROR_RECORD_SECTION_DESCRIPTOR指標的位址。

如果 WheaFindNextErrorRecordSection 函式在指定的 WHEA 錯誤記錄內找到下一個WHEA_ERROR_RECORD_SECTION_DESCRIPTOR結構，則函式會將 SectionDescriptor 參數設定為指定 WHEA 錯誤記錄內該結構的位址。

[out, optional] SectionData

PVOID 指標的位址。

如果 WheaFindNextErrorRecordSection 函式在指定的 WHEA 錯誤記錄內找到下一個WHEA_ERROR_RECORD_SECTION_DESCRIPTOR結構，則函式會將 SectionData 參數設定為與該描述元相關聯的硬體錯誤數據位址。

此參數是選擇性的，如果不需要錯誤記錄區段數據的指標，則必須設定為 NULL 。

傳回值

WheaFindNextErrorRecordSection 會傳回下列其中一個 NTSTATUS 代碼：

備註

如果 Context 參數設定為 0，WheaFindNextErrorRecordSection 會傳回 WHEA 錯誤記錄內第一個WHEA_ERROR_RECORD_SECTION_DESCRIPTOR結構的指標。 WheaFindNextErrorRecordSection 也會使用透過 SectionDescriptor 參數傳回之WHEA_ERROR_RECORD_SECTION_DESCRIPTOR相關的狀態資訊來更新 Context 參數。

在後續呼叫 WheaFindNextErrorRecordSection 時，如果 WHEA 錯誤記錄內有可用的) ，函式會傳回下一個WHEA_ERROR_RECORD_SECTION_DESCRIPTOR結構 (。 如果函式找到下一個WHEA_ERROR_RECORD_SECTION_DESCRIPTOR結構，它會更新 Context 參數。 否則，函式會傳回STATUS_NOT_FOUND。

若要在指定的 WHEA 錯誤記錄中找到第一個WHEA_ERROR_RECORD_SECTION_DESCRIPTOR，呼叫端必須在呼叫之前，將位址傳入 Context 參數中的變數設定為 0。 之後，呼叫端在尋找下一個WHEA_ERROR_RECORD_SECTION_DESCRIPTOR透過 對 WheaFindNextErrorRecordSection 的後續呼叫時，不得修改變量的值。

此外，如果 WheaFindNextErrorRecordSection 傳回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 結構。

規格需求

另請參閱

錯誤記錄

WHEA_ERROR_PACKET

WHEA_ERROR_RECORD

WHEA_ERROR_RECORD_SECTION_DESCRIPTOR