Fonction PoFxPowerOnCrashdumpDevice (wdm.h)

Article
02/29/2024

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

Partager via