UcmUcsiPpmStop, fonction (ucmucsippm.h)

Indique à l’extension de classe UcmUcsiCx d’arrêter d’envoyer des requêtes au pilote client.

Syntaxe

void UcmUcsiPpmStop(
  [in] UCMUCSIPPM PpmObject
);

Paramètres

[in] PpmObject

Handle d’un objet Platform Policy Manager (PPM) que le pilote client a reçu lors de l’appel précédent à UcmUcsiPpmCreate.

Valeur de retour

None

Remarques

UcmUcsiPpmStop indique que le pilote client n’est plus prêt à recevoir des requêtes de l’extension de classe. L’extension de classe garantit qu’il n’y aura pas de demandes adressées au client après le retour de cet appel. Le pilote doit appeler cette DDI lorsqu’elle rencontre une erreur et souhaite que l’extension de classe cesse d’envoyer des requêtes PPM. Une fois l’appel terminé, le pilote doit redémarrer le ppm à l’aide de UcmUcsiPpmStart.

Le pilote client est censé appeler cette DDI lors du déchargement du pilote. Cet appel indique que l’extension de classe doit commencer à détruire ses machines d’état internes. Il est recommandé que le client appelle UcmUcsiPpmStop à partir de son rappel EVT_WDF_DEVICE_RELEASE_HARDWARE.

Étant donné que UcmUcsiPpmStop s’appuie sur l’envoi de commandes UCSI à PPM sur le WDFQUEUE géré par l’alimentation fourni par le pilote client, une tentative d’appel de cette fonction à partir de EVT_WDF_DEVICE_D0_EXIT rappel entraîne un échec. En effet, à ce stade, les portes de répartition de la file d’attente sont fermées.

Une fois que UcmUcsiPpmStop est retourné, UcmUcsiPpmStart peut être appelé pour redémarrer le PPM.

Configuration requise

Condition requise	Valeur
Version KMDF minimale	1,27 %
Version UMDF minimale	N/A
En-tête	ucmucsippm.h (include UcmUcsiCx.h)
Bibliothèque	UcmUcsiCxStub.lib
IRQL	PASSIVE_LEVEL