WheaFindErrorRecordSection-Funktion (ntddk.h)
Die WheaFindErrorRecordSection-Funktion sucht nach einem angegebenen WhEA-Fehlerdatensatzabschnitt (Windows Hardware Error Architecture, WHEA) innerhalb eines WHEA-Fehlerdatensatzes. Der Fehlerdatensatzabschnitt ist als WHEA_ERROR_RECORD_SECTION_DESCRIPTOR Struktur formatiert.
Syntax
NTSTATUS WheaFindErrorRecordSection(
[in] PWHEA_ERROR_RECORD Record,
[in] const GUID *SectionType,
[out] PWHEA_ERROR_RECORD_SECTION_DESCRIPTOR *SectionDescriptor,
[out, optional] PVOID *SectionData
);
Parameter
[in] Record
Ein Zeiger auf einen WHEA-Fehlerdatensatz, der als WHEA_ERROR_RECORD Struktur formatiert ist.
[in] SectionType
Eine GUID, die die WHEA_ERROR_RECORD_SECTION_DESCRIPTOR Struktur angibt, die innerhalb des angegebenen WHEA-Fehlerdatensatzesgefunden werden soll.
[out] SectionDescriptor
Die Adresse eines WHEA_ERROR_RECORD_SECTION_DESCRIPTOR Zeigers.
Wenn die WheaFindErrorRecordSection-Funktion die angegebene WHEA_ERROR_RECORD_SECTION_DESCRIPTOR Struktur findet, legt die Funktion den SectionDescriptor Parameter auf die Adresse dieser Struktur innerhalb des angegebenen WHEA Fehlerdatensatzfest.
[out, optional] SectionData
Die Adresse eines PVOID-Zeigers.
Wenn die WheaFindErrorRecordSection-Funktion die angegebene WHEA_ERROR_RECORD_SECTION_DESCRIPTOR Struktur findet, legt die Funktion den Parameter SectionData auf die Adresse der Hardwarefehlerdaten fest, die diesem Deskriptor innerhalb des angegebenen WHEA Fehlerdatensatz zugeordnet sind.
Dieser Parameter ist optional und muss auf NULL- festgelegt werden, wenn kein Zeiger auf die Hardwarefehlerdaten erforderlich ist.
Rückgabewert
WheaFindErrorRecordSection gibt einen der folgenden NTSTATUS-Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die angegebene WHEA_ERROR_RECORD_SECTION_DESCRIPTOR Struktur wurde gefunden. |
| STATUS_NOT_FOUND | Die angegebene WHEA_ERROR_RECORD_SECTION_DESCRIPTOR Struktur wurde nicht gefunden. |
| STATUS_INVALID_PARAMETER | Entweder die Parameter Record, SectionType, oder SectionDescriptor parameter wurden auf NULLfestgelegt, oder der WHEA Fehlerdatensatz, auf den über den Parameter Record verwiesen wird, ist ungültig. |
Bemerkungen
Wenn WheaFindErrorRecordSection STATUS_SUCCESS zurückgibt, hat sie die WHEA_ERROR_RECORD_SECTION_DESCRIPTOR Struktur gefunden, die über den Guid--Parameter angegeben wurde. WheaFindErrorRecordSection legt den parameter SectionDescriptor auf die Adresse der WHEA_ERROR_RECORD_SECTION_DESCRIPTOR-Struktur fest.
Wenn WheaFindErrorRecordSection STATUS_SUCCESS zurückgibt und der Aufrufer den Parameter SectionData auf die Adresse einer PVOID-Zeigervariable festlegt, aktualisiert die Funktion den Parameter mit der Adresse der Hardwarefehlerdaten, die der angegebenen WHEA_ERROR_RECORD_SECTION_DESCRIPTOR Struktur zugeordnet sind.
Das Format der Hardwarefehlerdaten hängt vom SectionType Member der WHEA_ERROR_RECORD_SECTION_DESCRIPTOR Struktur ab, auf die über den SectionDescriptor-Parameter verwiesen wird. Wenn beispielsweise das SectionType Member den Wert PROCESSOR_GENERIC_ERROR_SECTION_GUID hat, werden die Hardwarefehlerdaten als WHEA_PROCESSOR_GENERIC_ERROR_SECTION Struktur formatiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in Windows 7 und höheren Versionen von Windows. |
| Zielplattform- | Desktop |
| Header- | ntddk.h (include Ntddk.h) |
| IRQL- | IRQL-<=DISPATCH_LEVEL |