Fonction WheaFindErrorRecordSection (ntddk.h)
La fonction WheaFindErrorRecordSection recherche un enregistrement d’erreur WHEA (Windows Hardware Error Architecture) spécifié dans un enregistrement d’erreur WHEA. La section d’enregistrement d’erreur est mise en forme en tant que structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR .
Syntaxe
NTSTATUS WheaFindErrorRecordSection(
[in] PWHEA_ERROR_RECORD Record,
[in] const GUID *SectionType,
[out] PWHEA_ERROR_RECORD_SECTION_DESCRIPTOR *SectionDescriptor,
[out, optional] PVOID *SectionData
);
Paramètres
[in] Record
Pointeur vers un enregistrement d’erreur WHEA mis en forme en tant que structure WHEA_ERROR_RECORD .
[in] SectionType
GUID qui spécifie la structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR à se trouver dans l’enregistrement d’erreur WHEA spécifié.
[out] SectionDescriptor
Adresse d’un pointeur WHEA_ERROR_RECORD_SECTION_DESCRIPTOR .
Si la fonction WheaFindErrorRecordSection localise la structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR spécifiée, la fonction définit le paramètre SectionDescriptor sur l’adresse de cette structure dans l’enregistrement d’erreur WHEA spécifié.
[out, optional] SectionData
Adresse d’un pointeur PVOID.
Si la fonction WheaFindErrorRecordSection localise la structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR spécifiée, la fonction définit le paramètre SectionData sur l’adresse des données d’erreur matérielle associées à ce descripteur dans l’enregistrement d’erreur WHEA spécifié.
Ce paramètre est facultatif et doit être défini sur NULL si un pointeur vers les données d’erreur matérielle n’est pas requis.
Valeur retournée
WheaFindErrorRecordSection retourne l’un des codes NTSTATUS suivants :
| Code de retour | Description |
|---|---|
| STATUS_SUCCESS | La structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR spécifiée a été trouvée. |
| STATUS_NOT_FOUND | La structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR spécifiée est introuvable. |
| STATUS_INVALID_PARAMETER | Les paramètres Record, SectionType ou SectionDescriptor ont été définis sur NULL, ou l’enregistrement d’erreur WHEA référencé via le paramètre Record n’est pas valide. |
Remarques
Si WheaFindErrorRecordSection retourne STATUS_SUCCESS, il a localisé la structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR spécifiée via le paramètre GUID . WheaFindErrorRecordSection définit le paramètre SectionDescriptor sur l’adresse de la structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR située.
En outre, si WheaFindErrorRecordSection retourne STATUS_SUCCESS et que l’appelant définit le paramètre SectionData sur l’adresse d’une variable de pointeur PVOID, la fonction met à jour le paramètre avec l’adresse des données d’erreur matérielle associées à la structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR spécifiée.
Le format des données d’erreur matérielle dépend du membre SectionType de la structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR référencée via le paramètre SectionDescriptor . Par exemple, si le membre SectionType a la valeur PROCESSOR_GENERIC_ERROR_SECTION_GUID, les données d’erreur matérielle sont mises en forme en tant que structure WHEA_PROCESSOR_GENERIC_ERROR_SECTION .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge dans Windows 7 et les versions ultérieures de Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | ntddk.h (inclure Ntddk.h) |
| IRQL | IRQL <=DISPATCH_LEVEL |