Fonction PoFxRegisterCrashdumpDevice (wdm.h)
La routine PoFxRegisterCrashdumpDevice enregistre un appareil de vidage sur incident.
Syntaxe
NTSTATUS PoFxRegisterCrashdumpDevice(
POHANDLE Handle
);
Paramètres
Handle
Handle qui représente l’inscription de l’appareil de vidage sur incident auprès de l’infrastructure de gestion de l’alimentation Windows (PoFx). Le pilote de périphérique a déjà reçu ce handle de la routine PoFxRegisterDevice .
Valeur retournée
PoFxRegisterCrashdumpDevice retourne STATUS_SUCCESS si la routine enregistre correctement l’appareil de vidage sur incident. Les valeurs de retour d’erreur possibles incluent les codes status suivants.
| Valeur retournée | Description |
|---|---|
|
Valeur de handle non valide. |
|
Il n’existe aucun PEP pour cet appareil. |
Remarques
Cette routine est appelée par le pilote d’un périphérique de vidage sur incident pour informer PoFx que l’appareil fait partie de la chaîne d’appareils de vidage sur incident. Plusieurs appareils (contrôleur de stockage, contrôleur PCI, etc.) peuvent devoir être activés afin que le noyau Windows puisse écrire un fichier de vidage sur le disque. Lorsqu’une erreur système irrécupérable se produit, le noyau tente d’activer les appareils de vidage sur incident et d’enregistrer le fichier de vidage sur incident.
Le pilote doit appeler PoFxRegisterDevice pour inscrire l’appareil auprès de PoFx avant d’appeler PoFxRegisterCrashdumpDevice.
Le pilote d’un périphérique de vidage sur incident peut appeler la routine PoFxPowerOnCrashdumpDevice pour demander au PEP d’activer l’appareil.
Pour plus d’informations sur les vidages sur incident, consultez Fichiers de vidage en mode noyau.
PoFxRegisterCrashdumpDevice doit être appelé à l’adresse IRQL = PASSIVE_LEVEL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8.1. |
| Plateforme cible | Windows |
| En-tête | wdm.h (inclure Pepfx.h) |
| Bibliothèque | Ntoskrnl.lib |
| IRQL | PASSIVE_LEVEL |