função UsbPm_Register (usbpmapi.h)

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

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 a macro USBPM_CLIENT_CONFIG_INIT.

[Out] ClientHandle

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

Valor de retorno

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

Observações

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