função UsbPm_Register (usbpmapi.h)

  • Artigo

Registra o driver do cliente com o Gerenciador de Políticas para relatar as alterações de estado de chegada/remoção e conector do hub.

Sintaxe

NTSTATUS UsbPm_Register(
  [In]  PUSBPM_CLIENT_CONFIG ClientConfig,
  [Out] USBPM_CLIENT         *ClientHandle
);

Parâmetros

[In] ClientConfig

O ponteiro para uma estrutura de USBPM_CLIENT_CONFIG fornecida pelo chamador. Inicialize a estrutura chamando macro USBPM_CLIENT_CONFIG_INIT.

[Out] ClientHandle

Um ponteiro para um local que recebe um identificador para a operação de registro.

Retornar valor

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

Comentários

As funções de retorno de chamada do driver cliente podem começar a ser invocadas antes que UsbPm_Register retorne. O valor ClientHandle é definido como um valor válido antes que as funções de retorno de chamada sejam invocadas.

O driver normalmente chama UsbPm_Register no EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT do driver e cancela o registro em EVT_WDF_DEVICE_SELF_MANAGED_IO_CLEANUP chamando UsbPm_Deregister.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1809
Versão mínima do KMDF 1.27
Versão mínima do UMDF 2.27
Cabeçalho usbpmapi.h
Biblioteca UsbPmApi.lib
IRQL PASSIVE_LEVEL