Função UcmUcsiPpmStop (ucmucsippm.h)

Instrui a extensão de classe UcmUcsiCx a parar de enviar solicitações para o driver cliente.

Sintaxe

void UcmUcsiPpmStop(
  [in] UCMUCSIPPM PpmObject
);

Parâmetros

[in] PpmObject

Um identificador para um objeto PPM (Platform Policy Manager) que o driver cliente recebeu na chamada anterior para UcmUcsiPpmCreate.

Retornar valor

Nenhum

Comentários

UcmUcsiPpmStop indica que o driver cliente não está mais pronto para receber solicitações da extensão de classe. A extensão de classe garante que não haverá nenhuma solicitação feita ao cliente depois que essa chamada retornar. O driver deve chamar essa DDI quando encontrar uma falha e quiser que a extensão de classe pare de enviar solicitações PPM. Após a conclusão da chamada, o driver deve iniciar o PPM novamente usando UcmUcsiPpmStart.

Espera-se que o driver cliente chame essa DDI no descarregamento do driver. Essa chamada indica a extensão de classe para começar a destruir seus computadores de estado internos. É recomendável que o cliente chame UcmUcsiPpmStop de seu retorno de chamada EVT_WDF_DEVICE_RELEASE_HARDWARE.

Como UcmUcsiPpmStop depende do envio de comandos UCSI para PPM pelo WDFQUEUE gerenciado por energia fornecido pelo driver cliente, uma tentativa de chamar essa função de EVT_WDF_DEVICE_D0_EXIT retorno de chamada resulta em uma falha. Isso porque, neste momento, os portões de expedição da fila estão fechados.

Depois que o UcmUcsiPpmStop retornar, UcmUcsiPpmStart poderá ser chamado para iniciar o PPM novamente.

Requisitos

Requisito	Valor
Versão mínima do KMDF	1.27
Versão mínima do UMDF	N/D
Cabeçalho	ucmucsippm.h (inclua UcmUcsiCx.h)
Biblioteca	UcmUcsiCxStub.lib
IRQL	PASSIVE_LEVEL