funzione UsbPm_Register (usbpmapi.h)

Registra il driver client con Policy Manager per segnalare modifiche allo stato dell'hub di arrivo/rimozione e connettore.

Sintassi

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

Parametri

[In] ClientConfig

Puntatore a una struttura di USBPM_CLIENT_CONFIG fornita dal chiamante. Inizializzare la struttura chiamando la macro USBPM_CLIENT_CONFIG_INIT.

[Out] ClientHandle

Puntatore a una posizione che riceve un handle per l'operazione di registrazione.

Valore restituito

Restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, restituisce un valore NTSTATUS appropriato.

Commenti

Le funzioni di callback del driver client potrebbero iniziare a essere richiamate prima di UsbPm_Register restituisce. Il valore ClientHandle è impostato su un valore valido prima che vengano richiamate le funzioni di callback.

Il driver chiama in genere UsbPm_Register nei EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT del conducente e annulla la registrazione in EVT_WDF_DEVICE_SELF_MANAGED_IO_CLEANUP chiamando UsbPm_Deregister.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1809
Versione KMDF minima	1.27
Versione UMDF minima	2.27
Intestazione	usbpmapi.h
Libreria	UsbPmApi.lib
IRQL	PASSIVE_LEVEL