UsbPm_Register-Funktion (usbpmapi.h)

Registriert den Clienttreiber beim Richtlinien-Manager, um Änderungen des Hub-Ankunfts-/Entfernungs- und Connectorstatus zu melden.

Syntax

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

Parameter

[In] ClientConfig

Der Zeiger auf eine vom Aufrufer bereitgestellte USBPM_CLIENT_CONFIG Struktur. Initialisieren Sie die Struktur durch Aufrufen des Makros USBPM_CLIENT_CONFIG_INIT.

[Out] ClientHandle

Ein Zeiger auf einen Speicherort, der ein Handle für den Registrierungsvorgang empfängt.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Gibt andernfalls einen geeigneten NTSTATUS- Wert zurück.

Bemerkungen

Die Rückruffunktionen des Clienttreibers werden möglicherweise aufgerufen, bevor UsbPm_Register zurückgegeben wird. Der ClientHandle- Wert wird auf einen gültigen Wert festgelegt, bevor Rückruffunktionen aufgerufen werden.

Der Treiber ruft in der Regel UsbPm_Register im EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT des Treibers auf und hebt die Registrierung in EVT_WDF_DEVICE_SELF_MANAGED_IO_CLEANUP auf, indem UsbPm_Deregisteraufgerufen wird.

Anforderungen