UcmUcsiPpmStart, fonction (Ucmucsippm.h)

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

Syntaxe

NTSTATUS UcmUcsiPpmStart(
  [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 retournée

Retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette méthode peut retourner une valeur NTSTATUS appropriée.

Remarques

UcmUcsiPpmStart indique que le pilote client est maintenant prêt à recevoir la demande de l’extension de classe. Lors de cet appel, l’extension de classe démarre les machines d’état du Gestionnaire de stratégie de système d’exploitation (OPM) et du gestionnaire de commandes.

Le pilote client doit appeler UcmUcsiPpmStart après avoir appelé UcmUcsiPpmStop pour la récupération d’erreur.

Cette DDI démarre les opérations que l’extension de classe doit effectuer pour initialiser les machines d’état OPM et Command Handler. Le pilote client doit appeler UcmUcsiPpmStart pour informer UcmUcsiCx que le pilote est prêt à recevoir les demandes IOCTL. Nous vous recommandons d’effectuer cet appel à partir de la fonction de rappel EVT_WDF_DEVICE_PREPARE_HARDWARE ou après que le système a appelé ce rappel.

Une tentative de démarrage du ppm une fois qu’il a déjà démarré entraîne une condition d’erreur.

Une fois que le client a appelé UcmUcsiPpmStart, l’extension de classe envoie un certain nombre de commandes au microprogramme PPM afin d’obtenir les fonctionnalités ppm et de connecteur ainsi que leurs états. En raison d’un nombre élevé d’interactions avec le microprogramme, nous recommandons vivement aux implémenteurs du client UcmUcsiCx d’appeler cette DDI une fois au démarrage et non à la reprise à partir d’un état de faible consommation, comme le rappel D0Entry. Cela est particulièrement vrai lorsque le client implémente la mise au point de S0.

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