Compartilhar via

Função UcmUcsiPpmStart (Ucmucsippm.h)

  • Artigo

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

Sintaxe

NTSTATUS UcmUcsiPpmStart(
  [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

Retorna STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método pode retornar um valor NTSTATUS apropriado.

Comentários

UcmUcsiPpmStart indica que o driver cliente agora está pronto para receber a solicitação da extensão de classe. Após essa chamada, a extensão de classe inicia os computadores de estado OPM (Gerenciador de Políticas do SISTEMA Operacional) e Manipulador de Comandos.

O driver cliente deve chamar UcmUcsiPpmStart depois de ter chamado UcmUcsiPpmStop para recuperação de erro.

Essa DDI inicia as operações que a extensão de classe precisa executar para inicializar os computadores de estado OPM e Manipulador de Comandos. O driver cliente deve chamar UcmUcsiPpmStart para notificar UcmUcsiCx de que o driver está pronto para receber as solicitações ioctl. Recomendamos que você faça essa chamada da função de retorno de chamada EVT_WDF_DEVICE_PREPARE_HARDWARE ou depois que o sistema chamar esse retorno de chamada.

Tentar iniciar o PPM depois que ele já tiver iniciado leva a uma condição de erro.

Depois que o cliente chama UcmUcsiPpmStart, a extensão de classe envia vários comandos para o firmware PPM para obter as funcionalidades do PPM e do conector e seus status. Devido a um alto número de interações com o firmware, é altamente recomendável que os implementadores de cliente UcmUcsiCx chamem essa DDI uma vez durante a inicialização e não sejam retomados de um estado de baixa energia, como o retorno de chamada D0Entry. Isso é especialmente verdadeiro quando o cliente implementa a idling S0.

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