WheaFindNextErrorRecordSection-Funktion (ntddk.h)
Die WheaFindNextErrorRecordSection-Funktion ermöglicht es einem Aufrufer, die WHEA-Fehlerdatensatzabschnitte in einem WHEA-Fehlerdatensatz iterativ zu untersuchen. Jeder Fehlerdatensatzabschnitt ist als WHEA_ERROR_RECORD_SECTION_DESCRIPTOR-Struktur formatiert.
Syntax
NTSTATUS WheaFindNextErrorRecordSection(
[in] PWHEA_ERROR_RECORD Record,
[in, out] ULONG *Context,
[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, out] Context
Ein Zeiger auf eine ULONG-Variable, die den aktuellen Status der Suche beibehält.
Diese Variable muss vor dem ersten Aufruf der Funktion WheaFindNextErrorRecordSection auf null initialisiert werden.
[out] SectionDescriptor
Die Adresse eines WHEA_ERROR_RECORD_SECTION_DESCRIPTOR-Zeigers .
Wenn die WheaFindNextErrorRecordSection-Funktion die nächste WHEA_ERROR_RECORD_SECTION_DESCRIPTOR-Struktur innerhalb des angegebenen WHEA-Fehlerdatensatzes findet, legt die Funktion den SectionDescriptor-Parameter auf die Adresse dieser Struktur innerhalb des angegebenen WHEA-Fehlerdatensatzes fest.
[out, optional] SectionData
Die Adresse eines PVOID-Zeigers.
Wenn die WheaFindNextErrorRecordSection-Funktion die nächste WHEA_ERROR_RECORD_SECTION_DESCRIPTOR-Struktur innerhalb des angegebenen WHEA-Fehlerdatensatzes findet, legt die Funktion den SectionData-Parameter auf die Adresse der Hardwarefehlerdaten fest, die diesem Deskriptor zugeordnet sind.
Dieser Parameter ist optional und muss auf NULL festgelegt werden, wenn kein Zeiger auf die Fehlerdatensatzabschnittsdaten erforderlich ist.
Rückgabewert
WheaFindNextErrorRecordSection gibt einen der folgenden NTSTATUS-Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die nächste WHEA_ERROR_RECORD_SECTION_DESCRIPTOR-Struktur wurde gefunden. |
| STATUS_NOT_FOUND | Die nächste WHEA_ERROR_RECORD_SECTION_DESCRIPTOR-Struktur wurde nicht gefunden. |
| STATUS_INVALID_PARAMETER | Entweder wurden die Parameter Record, SectionType oder SectionDescriptor auf NULL festgelegt, oder die WHEA_ERROR_RECORD Daten, auf die über den Record-Parameter verwiesen wird, ist ungültig. |
Hinweise
Wenn der Context-Parameter auf 0 festgelegt ist, gibt WheaFindNextErrorRecordSection einen Zeiger auf die erste WHEA_ERROR_RECORD_SECTION_DESCRIPTOR-Struktur innerhalb eines WHEA-Fehlerdatensatzes zurück. WheaFindNextErrorRecordSection aktualisiert auch den Context-Parameter mit Zustandsinformationen im Zusammenhang mit der WHEA_ERROR_RECORD_SECTION_DESCRIPTOR, die über den SectionDescriptor-Parameter zurückgegeben werden.
Bei nachfolgenden Aufrufen von WheaFindNextErrorRecordSection gibt die Funktion die nächste WHEA_ERROR_RECORD_SECTION_DESCRIPTOR-Struktur (sofern verfügbar) innerhalb des WHEA-Fehlerdatensatzes zurück. Wenn die Funktion die nächste WHEA_ERROR_RECORD_SECTION_DESCRIPTOR Struktur sucht, wird der Context-Parameter aktualisiert. Andernfalls gibt die Funktion STATUS_NOT_FOUND zurück.
Um die erste WHEA_ERROR_RECORD_SECTION_DESCRIPTOR innerhalb des angegebenen WHEA-Fehlerdatensatzes zu finden, muss der Aufrufer die Variable, deren Adresse im Context-Parameter übergeben wird, vor dem Aufruf auf 0 festlegen. Danach darf der Aufrufer den Wert der Variablen nicht ändern, wenn der nächste WHEA_ERROR_RECORD_SECTION_DESCRIPTOR durch nachfolgende Aufrufe von WheaFindNextErrorRecordSection gesucht wird.
Wenn WheaFindNextErrorRecordSection STATUS_SUCCESS zurückgibt und der Aufrufer den SectionData-Parameter 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-Element der WHEA_ERROR_RECORD_SECTION_DESCRIPTOR-Struktur ab, auf die über den SectionDescriptor-Parameter verwiesen wird. Wenn das SectionType-Element beispielsweise den Wert PROCESSOR_GENERIC_ERROR_SECTION_GUID hat, werden die Hardwarefehlerdaten als WHEA_PROCESSOR_GENERIC_ERROR_SECTION-Struktur formatiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt in Windows 7 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | ntddk.h (include Ntddk.h) |
| IRQL | IRQL <= DISPATCH_LEVEL |