Fonction PoFxRegisterCrashdumpDevice (wdm.h)

  • Article

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
STATUS_INVALID_PARAMETER
 Valeur de handle non valide.
STATUS_UNSUCCESSFUL
 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

Voir aussi

PoFxPowerOnCrashdumpDevice

PoFxRegisterDevice