Funzione WheaFindNextErrorRecordSection (ntddk.h)
La funzione WheaFindNextErrorRecordSection consente a un chiamante di esaminare in modo iterativo le sezioni del record di errore WHEA all'interno di un record di errore WHEA. Ogni sezione del record di errore viene formattata come struttura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR .
Sintassi
NTSTATUS WheaFindNextErrorRecordSection(
[in] PWHEA_ERROR_RECORD Record,
[in, out] ULONG *Context,
[out] PWHEA_ERROR_RECORD_SECTION_DESCRIPTOR *SectionDescriptor,
[out, optional] PVOID *SectionData
);
Parametri
[in] Record
Puntatore a un record di errore WHEA formattato come struttura WHEA_ERROR_RECORD .
[in, out] Context
Puntatore a una variabile ULONG che mantiene lo stato corrente della ricerca.
Questa variabile deve essere inizializzata su zero prima della prima chiamata alla funzione WheaFindNextErrorRecordSection .
[out] SectionDescriptor
Indirizzo di un puntatore WHEA_ERROR_RECORD_SECTION_DESCRIPTOR .
Se la funzione WheaFindNextErrorRecordSection individua la struttura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR successiva all'interno del record di errore WHEA specificato, la funzione imposta il parametro SectionDescriptor sull'indirizzo della struttura all'interno del record di errore WHEA specificato.
[out, optional] SectionData
Indirizzo di un puntatore PVOID.
Se la funzione WheaFindNextErrorRecordSection individua la struttura di WHEA_ERROR_RECORD_SECTION_DESCRIPTOR successiva all'interno del record di errore WHEA specificato, la funzione imposta il parametro SectionData sull'indirizzo dei dati di errore hardware associati a tale descrittore.
Questo parametro è facoltativo e deve essere impostato su NULL se non è necessario un puntatore ai dati della sezione del record di errore.
Valore restituito
WheaFindNextErrorRecordSection restituisce uno dei codici NTSTATUS seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | È stata trovata la struttura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR successiva. |
| STATUS_NOT_FOUND | Impossibile trovare la struttura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR successiva. |
| STATUS_INVALID_PARAMETER | I parametri Record, SectionType o SectionDescriptor sono stati impostati su NULL oppure i dati di WHEA_ERROR_RECORD a cui viene fatto riferimento tramite il parametro Record non sono validi. |
Commenti
Se il parametro Context è impostato su 0, WheaFindNextErrorRecordSection restituisce un puntatore alla prima struttura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR all'interno di un record di errore WHEA. WheaFindNextErrorRecordSection aggiornerà anche il parametro Context con informazioni sullo stato correlate al WHEA_ERROR_RECORD_SECTION_DESCRIPTOR restituito tramite il parametro SectionDescriptor .
Nelle chiamate successive a WheaFindNextErrorRecordSection, la funzione restituisce la struttura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR successiva ,se disponibile, all'interno del record di errore WHEA. Se la funzione individua la struttura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR successiva, aggiornerà il parametro Context . In caso contrario, la funzione restituirà STATUS_NOT_FOUND.
Per individuare il primo WHEA_ERROR_RECORD_SECTION_DESCRIPTOR all'interno del record di errore WHEA specificato, il chiamante deve impostare la variabile, il cui indirizzo viene passato nel parametro Context , su 0 prima della chiamata. Successivamente, il chiamante non deve modificare il valore della variabile quando si individua il WHEA_ERROR_RECORD_SECTION_DESCRIPTOR successivo tramite le chiamate successive a WheaFindNextErrorRecordSection.
Inoltre, se WheaFindNextErrorRecordSection restituisce STATUS_SUCCESS e il chiamante imposta il parametro SectionData sull'indirizzo di una variabile di puntatore PVOID, la funzione aggiorna il parametro con l'indirizzo dei dati di errore hardware associati alla struttura di WHEA_ERROR_RECORD_SECTION_DESCRIPTOR specificata.
Il formato dei dati degli errori hardware dipende dal membro SectionType della struttura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR a cui viene fatto riferimento tramite il parametro SectionDescriptor . Ad esempio, se il membro SectionType ha il valore PROCESSOR_GENERIC_ERROR_SECTION_GUID, i dati degli errori hardware vengono formattati come struttura WHEA_PROCESSOR_GENERIC_ERROR_SECTION .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato in Windows 7 e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | ntddk.h (include Ntddk.h) |
| IRQL | IRQL <= DISPATCH_LEVEL |