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

指定した 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 コードのいずれかを返します。

注釈

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 構造として書式設定されます。

要件

こちらもご覧ください

エラー レコード

WHEA_ERROR_RECORD

WHEA_ERROR_RECORD_SECTION_DESCRIPTOR