Fonction PoFxPowerOnCrashdumpDevice (wdm.h)

La routine PoFxPowerOnCrashdumpDevice demande qu’un appareil de vidage sur incident soit activé.

Syntaxe

NTSTATUS PoFxPowerOnCrashdumpDevice(
  [in]           POHANDLE Handle,
  [in, optional] PVOID    Context
);

Paramètres

[in] 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 précédemment reçu ce handle de la routine PoFxRegisterDevice .

[in, optional] Context

Pointeur vers un contexte spécifique à l’appareil. Ce pointeur est passé en tant que paramètre d’entrée à la routine de rappel PowerOnDumpDeviceCallback implémentée par le plug-in d’extension de plateforme (PEP) pour l’appareil. Les informations de contexte sont stockées dans un format défini par le pilote de périphérique et compris par le PEP. Ce contexte est opaque pour le système d’exploitation. Le pilote peut définir ce paramètre sur NULL si le pep ne nécessite pas de contexte.

Valeur retournée

PoFxPowerOnCrashdumpDevice retourne STATUS_SUCCESS si la routine réussit à allumer l’appareil. Les valeurs de retour d’erreur possibles incluent les codes status suivants.

Remarques

Le pilote d’un appareil de vidage sur incident appelle cette routine pour demander au plug-in d’extension de plateforme (PEP) d’activer l’appareil afin qu’un vidage sur incident puisse être enregistré. Tous les appareils de la chaîne de vidage sur incident (qui peut inclure un contrôleur de stockage, un contrôleur PCI, etc.) doivent être activés pour qu’un fichier de vidage sur incident puisse être écrit sur le disque.

Pour plus d’informations sur les vidages sur incident, consultez Fichiers de vidage en mode noyau.

Cette routine peut être appelée dans IRQL <= HIGH_LEVEL.

Configuration requise

Voir aussi

PoFxRegisterDevice

PowerOnDumpDeviceCallback