UcmUcsiPpmStart-Funktion (Ucmucsippm.h)

Artikel
02/07/2025

Weist die UcmUcsiCx-Klassenerweiterung an, mit dem Senden von Anforderungen an den Clienttreiber zu beginnen.

Syntax

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

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls kann diese Methode einen geeigneten NTSTATUS- Wert zurückgeben.

Bemerkungen

UcmUcsiPpmStart gibt an, dass der Clienttreiber jetzt bereit ist, eine Anforderung von der Klassenerweiterung zu erhalten. Bei diesem Aufruf startet die Klassenerweiterung betriebssystemrichtlinien-Manager (OPM) und Command Handler-Zustandscomputer.

Der Clienttreiber muss UcmUcsiPpmStart- aufrufen, nachdem er ucmUcsiPpmStop für die Fehlerwiederherstellung aufgerufen hat.

Dieser DDI startet die Vorgänge, die die Klassenerweiterung ausführen muss, um die OPM- und Command Handler-Zustandscomputer zu initialisieren. Der Clienttreiber muss UcmUcsiPpmStart- aufrufen, um UcmUcsiCx zu benachrichtigen, dass der Treiber bereit ist, die IOCTL-Anforderungen zu empfangen. Es wird empfohlen, diesen Aufruf entweder über die EVT_WDF_DEVICE_PREPARE_HARDWARE Rückruffunktion oder nach dem Aufruf dieses Rückrufs durch das System vorzunehmen.

Der Versuch, das PPM zu starten, nachdem es bereits gestartet wurde, führt zu einer Fehlerbedingung.

Nachdem der Client UcmUcsiPpmStartaufruft, sendet die Klassenerweiterung eine Reihe von Befehlen an die PPM-Firmware, um PPM- und Connectorfunktionen und deren Status abzurufen. Aufgrund einer hohen Anzahl von Interaktionen mit der Firmware empfehlen wir dringend ucmUcsiCx-Clientimplementierer, diese DDI einmal während des Starts aufzurufen und nicht bei der Fortsetzung aus einem Energiesparzustand, z. B. D0Entry-Rückruf. Dies gilt insbesondere, wenn der Client S0 im Leerlauf implementiert.

Anforderungen

Anforderung	Wert
Minimale KMDF-Version	1.27
Mindest-UMDF-Version	N/A
Header-	Ucmucsippm.h (einschließlich UcmUcsiCx.h)
Library	UcmUcsiCxStub.lib
IRQL-	PASSIVE_LEVEL

Freigeben über