UcxUsbDeviceCreate-Funktion (ucxusbdevice.h)
Erstellt ein USB-Geräteobjekt auf dem angegebenen Controller.
Syntax
NTSTATUS UcxUsbDeviceCreate(
[in] UCXCONTROLLER Controller,
[out] PUCXUSBDEVICE_INIT *UsbDeviceInit,
[in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] UCXUSBDEVICE *UsbDevice
);
Parameter
[in] Controller
Ein Handle für das Controllerobjekt. Der Clienttreiber hat das Handle in einem vorherigen Aufruf von UcxControllerCreate abgerufen.
[out] UsbDeviceInit
Ein Zeiger auf eine UCXUSBDEVICE_INIT-Struktur , die verschiedene Konfigurationsvorgänge zum Erstellen des USB-Geräteobjekts beschreibt. Der Treiber gibt Funktionszeiger auf seine Rückruffunktionen in dieser Struktur an. Diese Struktur wird von UCX verwaltet.
[in, optional] Attributes
Ein Zeiger auf eine vom Aufrufer zugewiesene WDF_OBJECT_ATTRIBUTES-Struktur , die Attribute für das USB-Geräteobjekt angibt.
[out] UsbDevice
Ein Zeiger auf eine Variable, die ein Handle für das neue USB-Geräteobjekt empfängt.
Rückgabewert
Die -Methode gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode möglicherweise einen geeigneten NTSTATUS-Fehlercode zurück.
Hinweise
Der Clienttreiber für den Hostcontroller muss diese Methode nach dem WdfDeviceCreate-Aufruf aufrufen. Das übergeordnete Gerät des neuen USB-Geräteobjekts ist das übergeordnete Hubgerät, das von UCX angegeben wird.
Ein Codebeispiel finden Sie unter EVT_UCX_CONTROLLER_USBDEVICE_ADD.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 |
| Zielplattform | Windows |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | ucxusbdevice.h (include Ucxclass.h) |
| IRQL | PASSIVE_LEVEL |