UcmUcsiPpmStop, fonction (ucmucsippm.h)

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

Syntaxe

void UcmUcsiPpmStop(
  [in] UCMUCSIPPM PpmObject
);

Paramètres

[in] PpmObject

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

Valeur de retour

Aucun

Remarques

UcmUcsiPpmStop indique que le pilote client n’est plus prêt à recevoir des demandes de l’extension de classe. L’extension de classe garantit qu’il n’y aura aucune demande adressée au client une fois cet appel retourné. Le pilote doit appeler cette DDI lorsqu’il 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 sur le déchargement du pilote. Cet appel indique l’extension de classe pour 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 via 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. C’est parce qu’à ce stade, les portes de distribution de la file d’attente sont fermées.

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

Exigences

Exigence	Valeur
version minimale de KMDF	1.27
version minimale de UMDF	N/A
d’en-tête	ucmucsippm.h (include UcmUcsiCx.h)
bibliothèque	UcmUcsiCxStub.lib
IRQL	PASSIVE_LEVEL