UcmInitializeDevice-Funktion (ucmmanager.h)
Initialisiert die USB-Connector-Manager-Frameworkerweiterung (UcmCx).
Syntax
NTSTATUS UcmInitializeDevice(
[in] WDFDEVICE WdfDevice,
[in] PUCM_MANAGER_CONFIG Config
);
Parameter
[in] WdfDevice
Ein Handle für ein Framework-Geräteobjekt, das der Clienttreiber im vorherigen Aufruf von WdfDeviceCreate empfangen hat.
[in] Config
Ein Zeiger auf eine vom Aufrufer bereitgestellte UCM_MANAGER_CONFIG-Struktur , die durch Aufrufen von UCM_MANAGER_CONFIG_INIT initialisiert wird.
Rückgabewert
UcmInitializeDevice gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls kann diese Methode einen geeigneten NTSTATUS-Wert zurückgeben.
Hinweise
Diese Methode initialisiert UcmCx und ordnet erforderliche Ressourcen zu, registriert sich für PnP-Ereignisse und richtet E/A-Ziele ein. Der Clienttreiber muss diese Methode in der EVT_WDF_DRIVER_DEVICE_ADD Implementierung des Treibers aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 |
| Unterstützte Mindestversion (Server) | Windows Server 2016 |
| Zielplattform | Windows |
| KMDF-Mindestversion | 1.15 |
| UMDF-Mindestversion | 2.15 |
| Kopfzeile | ucmmanager.h (ucmcx.h einschließen) |
| Bibliothek | UcmCxstub.lib |
| IRQL | PASSIVE_LEVEL |