función UsbPm_Register (usbpmapi.h)

Registra el controlador de cliente con el Administrador de directivas para notificar los cambios de estado de llegada/eliminación del concentrador y del conector.

Sintaxis

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

Parámetros

[In] ClientConfig

Puntero a una estructura de USBPM_CLIENT_CONFIG proporcionada por el autor de la llamada. Inicialice la estructura mediante una llamada a USBPM_CLIENT_CONFIG_INIT de macros.

[Out] ClientHandle

Puntero a una ubicación que recibe un identificador de la operación de registro.

Valor devuelto

Devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, devuelve un valor NTSTATUS adecuado.

Comentarios

Las funciones de devolución de llamada del controlador cliente pueden empezar a invocarse antes de que se devuelva UsbPm_Register . El valor ClientHandle se establece en un valor válido antes de invocar las funciones de devolución de llamada.

Normalmente, el controlador llama a UsbPm_Register en el EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT del controlador y anula el registro en EVT_WDF_DEVICE_SELF_MANAGED_IO_CLEANUP llamando a UsbPm_Deregister.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1809
Versión mínima de KMDF	1.27
Versión mínima de UMDF	2,27
Encabezado	usbpmapi.h
Library	UsbPmApi.lib
IRQL	PASSIVE_LEVEL