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 構造体を検索する場合、関数は、指定された WHEA エラー レコード内でその記述子に関連付けられているハードウェア エラー データのアドレスに SectionData パラメーターを設定します。
このパラメーターは省略可能であり、ハードウェア エラー データへのポインターが必要ない場合は、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 |