Fonction PoFxPowerOnCrashdumpDevice (wdm.h)

  • Article

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.

Valeur retournée Description
STATUS_INVALID_PARAMETER
 Valeur de handle non valide.
STATUS_UNSUCCESSFUL
 Le PEP de cet appareil n’implémente pas de routine de rappel PowerOnDumpDeviceCallback ; ou le PEP n’a pas pu activer l’appareil.

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

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 8.1.
Plateforme cible Windows
En-tête wdm.h (incluez Pepfx.h)
Bibliothèque Ntoskrnl.lib
IRQL <= HIGH_LEVEL

Voir aussi

PoFxRegisterDevice

PowerOnDumpDeviceCallback