Funzione WheaFindErrorRecordSection (ntddk.h)
La funzione WheaFindErrorRecordSection cerca una sezione di errore WHEA (Windows Hardware Error Architecture) specificata all'interno di un record di errore WHEA. La sezione del record di errore viene formattata come struttura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR .
Sintassi
NTSTATUS WheaFindErrorRecordSection(
[in] PWHEA_ERROR_RECORD Record,
[in] const GUID *SectionType,
[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] SectionType
GUID che specifica la struttura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR da individuare all'interno del record di errore WHEA specificato.
[out] SectionDescriptor
Indirizzo di un puntatore WHEA_ERROR_RECORD_SECTION_DESCRIPTOR .
Se la funzione WheaFindErrorRecordSection individua la struttura di WHEA_ERROR_RECORD_SECTION_DESCRIPTOR specificata, 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 WheaFindErrorRecordSection individua la struttura di WHEA_ERROR_RECORD_SECTION_DESCRIPTOR specificata, la funzione imposta il parametro SectionData sull'indirizzo dei dati di errore hardware associati a tale descrittore all'interno del record di errore WHEA specificato.
Questo parametro è facoltativo e deve essere impostato su NULL se non è necessario un puntatore ai dati di errore hardware.
Valore restituito
WheaFindErrorRecordSection restituisce uno dei codici NTSTATUS seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | È stata trovata la struttura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR specificata. |
| STATUS_NOT_FOUND | Impossibile trovare la struttura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR specificata. |
| STATUS_INVALID_PARAMETER | I parametri Record, SectionType o SectionDescriptor sono stati impostati su NULL oppure il record di errore WHEA a cui viene fatto riferimento tramite il parametro Record non è valido. |
Commenti
Se WheaFindErrorRecordSection restituisce STATUS_SUCCESS, ha individuato la struttura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR specificata tramite il parametro Guid . WheaFindErrorRecordSection imposta il parametro SectionDescriptor sull'indirizzo della struttura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR localizzata.
Inoltre, se WheaFindErrorRecordSection 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 fa riferimento 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 |