WheaFindNextErrorRecordSection, fonction (ntddk.h)
La fonction WheaFindNextErrorRecordSection permet à un appelant d’examiner de manière itérative les sections d’enregistrement d’erreur WHEA dans un enregistrement d’erreur WHEA. Chaque section d’enregistrement d’erreur est mise en forme en tant que structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR .
Syntaxe
NTSTATUS WheaFindNextErrorRecordSection(
[in] PWHEA_ERROR_RECORD Record,
[in, out] ULONG *Context,
[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, out] Context
Pointeur vers une variable ULONG qui conserve l’état actuel de la recherche.
Cette variable doit être initialisée à zéro avant le premier appel à la fonction WheaFindNextErrorRecordSection .
[out] SectionDescriptor
Adresse d’un pointeur WHEA_ERROR_RECORD_SECTION_DESCRIPTOR .
Si la fonction WheaFindNextErrorRecordSection localise la structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR suivante dans l’enregistrement d’erreur WHEA spécifié, 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 WheaFindNextErrorRecordSection localise la structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR suivante dans l’enregistrement d’erreur WHEA spécifié, la fonction définit le paramètre SectionData sur l’adresse des données d’erreur matérielles associées à ce descripteur.
Ce paramètre est facultatif et doit être défini sur NULL si un pointeur vers les données de section d’enregistrement d’erreur n’est pas nécessaire.
Valeur retournée
WheaFindNextErrorRecordSection retourne l’un des codes NTSTATUS suivants :
| Code de retour | Description |
|---|---|
| STATUS_SUCCESS | La structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR suivante a été trouvée. |
| STATUS_NOT_FOUND | La structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR suivante est introuvable. |
| STATUS_INVALID_PARAMETER | Les paramètres Record, SectionType ou SectionDescriptor ont été définis sur NULL, ou les données WHEA_ERROR_RECORD référencées via le paramètre Record ne sont pas valides. |
Remarques
Si le paramètre Context est défini sur 0, WheaFindNextErrorRecordSection retourne un pointeur vers la première structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR dans un enregistrement d’erreur WHEA. WheaFindNextErrorRecordSection met également à jour le paramètre Context avec les informations d’état relatives aux WHEA_ERROR_RECORD_SECTION_DESCRIPTOR retournées par le biais du paramètre SectionDescriptor .
Lors des appels suivants à WheaFindNextErrorRecordSection, la fonction retourne la structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR suivante (si disponible) dans l’enregistrement d’erreur WHEA. Si la fonction localise la structure WHEA_ERROR_RECORD_SECTION_DESCRIPTOR suivante, elle met à jour le paramètre Context . Sinon, la fonction retourne STATUS_NOT_FOUND.
Pour localiser la première WHEA_ERROR_RECORD_SECTION_DESCRIPTOR dans l’enregistrement d’erreur WHEA spécifié, l’appelant doit définir la variable, dont l’adresse est passée dans le paramètre Context , sur 0 avant l’appel. Après cela, l’appelant ne doit pas modifier la valeur de la variable lors de la localisation de la WHEA_ERROR_RECORD_SECTION_DESCRIPTOR suivante via les appels suivants à WheaFindNextErrorRecordSection.
En outre, si WheaFindNextErrorRecordSection 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 de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR spécifiée.
Le format des données d’erreur matérielles 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 versions ultérieures de Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | ntddk.h (incluez Ntddk.h) |
| IRQL | IRQL <= DISPATCH_LEVEL |