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 |