UsbPm_Register-Funktion (usbpmapi.h)

  • Artikel

Registriert den Clienttreiber beim Richtlinien-Manager, um Die Ankunft/Entfernung des Hubs und Änderungen des 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, indem Sie makro-USBPM_CLIENT_CONFIG_INIT aufrufen.

[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. Andernfalls wird ein entsprechender NTSTATUS-Wert zurückgegeben.

Hinweise

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 er UsbPm_Deregister aufruft.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1809
KMDF-Mindestversion 1,27
UMDF-Mindestversion 2.27
Kopfzeile usbpmapi.h
Bibliothek UsbPmApi.lib
IRQL PASSIVE_LEVEL