Funzione UcmUcsiPpmStart (Ucmucsippm.h)

  • Articolo

Indica all'estensione della classe UcmUcsiCx di avviare l'invio di richieste al driver client.

Sintassi

NTSTATUS UcmUcsiPpmStart(
  [in] UCMUCSIPPM PpmObject
);

Parametri

[in] PpmObject

Handle per un oggetto Platform Policy Manager (PPM) ricevuto dal driver client nella chiamata precedente a UcmUcsiPpmCreate.

Valore restituito

Restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo può restituire un valore NTSTATUS appropriato.

Commenti

UcmUcsiPpmStart indica che il driver client è ora pronto per ricevere la richiesta dall'estensione della classe. Dopo questa chiamata, l'estensione della classe avvia Os Policy Manager (OPM) e i computer di stato del gestore comandi.

Il driver client deve chiamare UcmUcsiPpmStart dopo aver chiamato UcmUcsiPpmStop per il ripristino degli errori.

Questa DDI avvia le operazioni che l'estensione della classe deve eseguire per inizializzare i computer di stato del gestore comandi e OPM. Il driver client deve chiamare UcmUcsiPpmStart per notificare a UcmUcsiCx che il driver è pronto per ricevere le richieste IOCTL. È consigliabile effettuare questa chiamata dalla funzione di callback EVT_WDF_DEVICE_PREPARE_HARDWARE o dopo che il sistema chiama questo callback.

Il tentativo di avviare PPM dopo che è già stato avviato determina una condizione di errore.

Dopo che il client chiama UcmUcsiPpmStart, l'estensione della classe invia un numero di comandi al firmware PPM per ottenere le funzionalità ppm e connettore e i relativi stati. A causa di un numero elevato di interazioni con il firmware, consigliamo vivamente agli implementatori client UcmUcsiCx di chiamare questo DDI una volta durante l'avvio e non in caso di ripresa da uno stato a basso consumo, ad esempio il callback D0Entry. Questo vale soprattutto quando il client implementa S0 inattiva.

Requisiti

Requisito Valore
Versione KMDF minima 1.27
Versione UMDF minima N/D
Intestazione Ucmucsippm.h (include UcmUcsiCx.h)
Libreria UcmUcsiCxStub.lib
IRQL PASSIVE_LEVEL