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 ci saranno richieste inviate al client dopo la restituzione di questa chiamata. Il driver deve chiamare questa DDI quando si verifica 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 questa DDI durante lo scaricamento del driver. Questa chiamata indica l'estensione della classe per avviare l'disinstallazione delle macchine a stati interne. È 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 WDFQUEUE gestito dal driver client, un tentativo di chiamare questa funzione da EVT_WDF_DEVICE_D0_EXIT il callback genera un errore. Ciò è dovuto al fatto che in questo momento, i gate di invio per la coda vengono chiusi.

Al termine dell'UcmUcsiPpmStop, è possibile chiamare UcmUcsiPpmStart per avviare nuovamente ppm.

Fabbisogno

Requisito	Valore
versione minima di KMDF	1.27
versione minima di UMDF	N/D
intestazione	ucmucsippm.h (include UcmUcsiCx.h)
libreria	UcmUcsiCxStub.lib
IRQL	PASSIVE_LEVEL