Funzione UcmUcsiPpmStop (ucmucsippm.h)

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

Sintassi

void UcmUcsiPpmStop(
  [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

nessuno

Osservazioni

UcmUcsiPpmStop indica che il driver client non è più pronto per ricevere richieste dall'estensione della classe. L'estensione della classe garantisce che non vi saranno richieste inviate al client dopo la restituzione di questa chiamata. Il driver deve chiamare questo DDI quando rileva un errore e vuole che l'estensione della classe interrompa l'invio di richieste PPM. Al termine della chiamata, il driver deve avviare nuovamente ppm usando UcmUcsiPpmStart.

È previsto che il driver client chiami questo DDI durante lo scaricamento del driver. Questa chiamata indica l'estensione della classe per avviare l'disinstallazione dei computer di stato interni. È consigliabile che il client chiami UcmUcsiPpmStop dal callback EVT_WDF_DEVICE_RELEASE_HARDWARE.

Poiché UcmUcsiPpmStop si basa sull'invio di comandi UCSI a PPM tramite il WDFQUEUE gestito dall'alimentazione fornito dal driver client, un tentativo di chiamare questa funzione da EVT_WDF_DEVICE_D0_EXIT callback genera un errore. Ciò è dovuto al fatto che, in questo momento, i controlli di invio per la coda vengono chiusi.

Dopo la restituzione di UcmUcsiPpmStop , è possibile chiamare UcmUcsiPpmStart per avviare nuovamente PPM.

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