Compartilhar via


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.

Valor de retorno

Nenhum

Observações

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 for retornada. 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 derrubar 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 por meio do 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.

Após o UcmUcsiPpmStop retornar, UcmUcsiPpmStart pode 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/A
cabeçalho ucmucsippm.h (inclua UcmUcsiCx.h)
biblioteca UcmUcsiCxStub.lib
IRQL PASSIVE_LEVEL