UsbPm_Register-Funktion (usbpmapi.h)
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 |