WheaReportHwErrorDeviceDriver, fonction (ntddk.h)
Pour signaler une erreur matérielle, le pilote appelle la fonction WheaReportHwErrorDeviceDriver.
Syntaxe
NTSTATUS WheaReportHwErrorDeviceDriver(
ULONG ErrorSourceId,
PDEVICE_OBJECT DeviceObject,
PUCHAR ErrorData,
ULONG ErrorDataLength,
LPGUID SectionTypeGuid,
WHEA_ERROR_SEVERITY ErrorSeverity,
LPSTR DeviceFriendlyName
);
Paramètres
ErrorSourceId
ID de source d’erreur WHEA fourni lorsqu’il a appelé le rappel _WHEA_ERROR_SOURCE_INITIALIZE_DEVICE_DRIVER.
DeviceObject
Pointeur vers l’objet appareil associé à la condition d’erreur.
ErrorData
Mémoire tampon contenant les données d’erreur matérielle du pilote. Ces informations sont spécifiques au matériel et ne doivent pas dépasser la MaxRawDataLength que le pilote fourni à WheaAddErrorSourceDeviceDriver.
ErrorDataLength
Valeur de type ULONG spécifiant la taille, en octets, des données d’erreur.
SectionTypeGuid
Spécifie le type de données d’erreur signalé. Cela peut être, mais n’est pas obligatoire, l’un des GUID définis dans l’annexe N de l'spécification UEFI, auquel cas les informations d’erreur correspondent à l’un des types de section spécifiés. L’appelant peut également créer un GUID et un format de section privée.
ErrorSeverity
Valeur d’énumération de type WHEA_ERROR_SEVERITY en spécifiant la gravité de la condition d’erreur.
DeviceFriendlyName
Chaîne facultative allant jusqu’à 20 octets de longueur (y compris l’indicateur de fin NULL) qui décrit l’appareil associé à la condition d’erreur. Ces informations sont copiées dans l’enregistrement d’erreur WHEA résultant et sont uniquement informationnelles. L’intention est de placer ces informations dans l’enregistrement d’erreur afin que lorsque les journaux d’événements soient créés, un consommateur peut facilement résoudre les problèmes d’appareil.
Valeur de retour
Cette méthode de fonction retourne STATUS_SUCCESS ou un code d’erreur approprié.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10, version 1903 |
| d’en-tête | ntddk.h |