UcmUcsiPpmStop-Funktion (ucmucsippm.h)

Weist die UcmUcsiCx-Klassenerweiterung an, das Senden von Anforderungen an den Clienttreiber zu beenden.

Syntax

void UcmUcsiPpmStop(
  [in] UCMUCSIPPM PpmObject
);

Parameter

[in] PpmObject

Ein Handle für ein Platform Policy Manager (PPM)-Objekt, das der Clienttreiber im vorherigen Aufruf von UcmUcsiPpmCreateempfangen hat.

Rückgabewert

Nichts

Bemerkungen

UcmUcsiPpmStop gibt an, dass der Clienttreiber nicht mehr bereit ist, Anforderungen von der Klassenerweiterung zu empfangen. Die Klassenerweiterung garantiert, dass nach diesem Aufruf keine Anforderungen an den Client gestellt werden. Der Treiber sollte diesen DDI aufrufen, wenn ein Fehler auftritt und die Klassenerweiterung das Senden von PPM-Anforderungen beenden soll. Nach Abschluss des Aufrufs sollte der Treiber das PPM erneut mit UcmUcsiPpmStartstarten.

Der Clienttreiber wird erwartet, dass dieser DDI beim Entladen des Treibers aufgerufen wird. Dieser Aufruf gibt die Klassenerweiterung an, um mit dem Abreißen der internen Zustandscomputer zu beginnen. Es wird empfohlen, dass der Client UcmUcsiPpmStop- von seinem EVT_WDF_DEVICE_RELEASE_HARDWARE Rückruf aufruft.

Da UcmUcsiPpmStop- auf das Senden von UCSI-Befehlen an PPM über den vom Clienttreiber bereitgestellten WDFQUEUE angewiesen ist, führt ein Versuch, diese Funktion aus EVT_WDF_DEVICE_D0_EXIT Rückruf aufzurufen, zu einem Fehler. Das liegt daran, dass zu diesem Zeitpunkt die Versandtore für die Warteschleife geschlossen werden.

Nachdem die UcmUcsiPpmStop- zurückgegeben wurde, kann UcmUcsiPpmStart- aufgerufen werden, um das PPM erneut zu starten.

Anforderungen

Anforderung	Wert
Minimale KMDF-Version	1.27
Mindest-UMDF-Version	N/A
Header-	ucmucsippm.h (include UcmUcsiCx.h)
Library	UcmUcsiCxStub.lib
IRQL-	PASSIVE_LEVEL