UsbPm_Register, fonction (usbpmapi.h)

Inscrit le pilote client auprès de Policy Manager pour signaler les changements d’arrivée/suppression du hub et d’état du connecteur.

Syntaxe

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

Paramètres

[In] ClientConfig

Pointeur vers une structure de USBPM_CLIENT_CONFIG fournie par l’appelant. Initialisez la structure en appelant macro USBPM_CLIENT_CONFIG_INIT.

[Out] ClientHandle

Pointeur vers un emplacement qui reçoit un handle pour l’opération d’inscription.

Valeur retournée

Retourne STATUS_SUCCESS si l’opération réussit. Sinon, retourne une valeur NTSTATUS appropriée.

Remarques

Les fonctions de rappel du pilote client peuvent commencer à être appelées avant UsbPm_Register retours. La valeur ClientHandle est définie sur une valeur valide avant l’appel des fonctions de rappel.

Le pilote appelle généralement UsbPm_Register dans le EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT du pilote et se désinscrit dans EVT_WDF_DEVICE_SELF_MANAGED_IO_CLEANUP en appelant UsbPm_Deregister.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1809
Version KMDF minimale	1,27 %
Version UMDF minimale	2,27
En-tête	usbpmapi.h
Bibliothèque	UsbPmApi.lib
IRQL	PASSIVE_LEVEL