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

Weitere Informationen

UCM_MANAGER_CONFIG

UCM_MANAGER_CONFIG_INIT