UcxUsbDeviceCreate-Funktion (ucxusbdevice.h)

  • Artikel

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

Weitere Informationen

EVT_UCX_CONTROLLER_USBDEVICE_ADD