ucxusbdevice.h-Header

Dieser Header wird verwendet, um einen USB-Hostcontrollertreiber zu schreiben. Die USB-Hostcontrollererweiterung ist ein vom System bereitgestellter Treiber (Ucx01000.sys). Dieser Treiber wird als Frameworkklassenerweiterung mithilfe der Windows Driver Framework-Programmierschnittstellen implementiert. Der Hostcontrollertreiber dient als Clienttreiber für diese Klassenerweiterung. Während ein Hostcontrollertreiber Hardwarevorgänge und -ereignisse, Energieverwaltung und PnP-Ereignisse verarbeitet, dient UCX als abstrahierte Schnittstelle, die Anforderungen an den Hostcontrollertreiber in die Warteschlange stellt und andere Aufgaben ausführt.

Schließen Sie diesen Header nicht direkt ein. Schließen Sie stattdessen Ucxclass.h ein.

Weitere Informationen finden Sie unter

ucxusbdevice.h enthält die folgenden Programmierschnittstellen:

Functions

 
UCX_USBDEVICE_EVENT_CALLBACKS_INIT

Initialisiert eine UCX_USBDEVICE_EVENT_CALLBACKS-Struktur mit den Funktionszeigern auf die Rückruffunktionen des Clienttreibers.
UcxUsbDeviceCreate

Erstellt ein USB-Geräteobjekt auf dem angegebenen Controller.
UcxUsbDeviceInitSetEventCallbacks

Initialisiert eine UCXUSBDEVICE_INIT-Struktur mit den Ereignisrückruffunktionen des Clienttreibers.
UcxUsbDeviceRemoteWakeNotification

Benachrichtigt UCX, dass ein Remote-Aktivierungssignal vom Gerät empfangen wird.

Rückruffunktionen

 
EVT_UCX_USBDEVICE_ADDRESS

Die Implementierung des Clienttreibers, die UCX aufruft, um das USB-Gerät zu adressieren.
EVT_UCX_USBDEVICE_DEFAULT_ENDPOINT_ADD

Die Implementierung des Clienttreibers, die UCX aufruft, um einen neuen Standardendpunkt für ein USB-Gerät hinzuzufügen.
EVT_UCX_USBDEVICE_DISABLE

Die Implementierung des Clienttreibers, die UCX aufruft, um Controllerressourcen freizugeben, die dem Gerät und seinem Standardendpunkt zugeordnet sind.
EVT_UCX_USBDEVICE_ENABLE

Die Implementierung des Clienttreibers, die UCX aufruft, um Informationen zum Gerät und dessen Standardsteuerungsendpunkt in den Controller zu programmieren.
EVT_UCX_USBDEVICE_ENDPOINT_ADD

Die Implementierung des Clienttreibers, die UCX aufruft, um einen neuen Endpunkt für ein USB-Gerät hinzuzufügen.
EVT_UCX_USBDEVICE_ENDPOINTS_CONFIGURE

Die Implementierung des Clienttreibers, die UCX aufruft, um Endpunkte im Controller zu konfigurieren.
EVT_UCX_USBDEVICE_GET_CHARACTERISTIC

UCX ruft diesen Rückruf auf, um die Geräteeigenschaften abzurufen.
EVT_UCX_USBDEVICE_HUB_INFO

Die Implementierung des Clienttreibers, die UCX aufruft, um Hubeigenschaften abzurufen.
EVT_UCX_USBDEVICE_RESET

Die Implementierung des Clienttreibers, die UCX aufruft, wenn der Port, an den das Gerät angefügt ist, zurückgesetzt wird.
EVT_UCX_USBDEVICE_RESUME

UCX ruft diese Rückruffunktion auf, um ein Gerät aus dem Ruhezustand fortzusetzen.
EVT_UCX_USBDEVICE_SUSPEND

UCX ruft diese Rückruffunktion auf, um einen Geräteangehaltenen Zustand zu senden.
EVT_UCX_USBDEVICE_UPDATE

Die Implementierung des Clienttreibers, die UCX aufruft, um Geräteeigenschaften zu aktualisieren.

Strukturen

 
ADDRESS0_OWNERSHIP_ACQUIRE

Enthält Parameter zum Konfigurieren des Geräts.
UCX_USBDEVICE_CHARACTERISTIC

Speichert die Merkmale eines Geräts.
UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY

Erfahren Sie, wie UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY die Werte für die Verzögerung des isochronen Übertragungspfads speichert.
UCX_USBDEVICE_EVENT_CALLBACKS

Diese Struktur stellt eine Liste von UCX USB-Geräteereignisrückruffunktionen bereit.
UCXUSBDEVICE_INFO

Enthält Informationen zum USB-Gerät. Diese Struktur wird von UCX in der EVT_UCX_CONTROLLER_USBDEVICE_ADD Ereignisrückruffunktion übergeben.
USB_DEVICE_PORT_PATH

Enthält den Portpfad eines USB-Geräts.
USBDEVICE_ABORTIO

Enthält ein Handle für den USB-Hub (Universal Serial Bus), für den Datenübertragungen abgebrochen werden sollen.
USBDEVICE_ADDRESS

Enthält Parameter für eine Anforderung, um das angegebene Gerät in den Status Adress zu überstellen. Diese Struktur wird von UCX in Anforderungsparametern (Parameters.Others.Arg1) eines Frameworkanforderungsobjekts der EVT_UCX_USBDEVICE_ADDRESS Rückruffunktion übergeben.
USBDEVICE_DISABLE

Enthält Parameter für eine Anforderung zum Deaktivieren des angegebenen Geräts. Diese Struktur wird von UCX in Anforderungsparametern (Parameters.Others.Arg1) eines Frameworkanforderungsobjekts der EVT_UCX_USBDEVICE_DISABLE Rückruffunktion übergeben.
USBDEVICE_ENABLE

Enthält Parameter für eine Anforderung zum Aktivieren des angegebenen Geräts. Diese Struktur wird von UCX in Anforderungsparametern (Parameters.Others.Arg1) eines Frameworkanforderungsobjekts der EVT_UCX_USBDEVICE_ENABLE Rückruffunktion übergeben.
USBDEVICE_ENABLE_FAILURE_FLAGS

Die Flags, die vom Clienttreiber in der EVT_UCX_USBDEVICE_ENABLE Rückruffunktion festgelegt werden. Geben Sie ggf. Fehler an, die beim Aktivieren des Geräts aufgetreten sind.
USBDEVICE_HUB_INFO

Enthält Parameter für eine Anforderung zum Abrufen von Informationen zum angegebenen Hub. Diese Struktur wird von UCX in Anforderungsparametern (Parameters.Others.Arg1) eines Frameworkanforderungsobjekts der EVT_UCX_USBDEVICE_HUB_INFO Rückruffunktion übergeben.
USBDEVICE_MGMT_HEADER

Diese Struktur bietet einen Handle für den USB-Hub (Universal Serial Bus) oder das Gerät, das physisch mit dem Bus verbunden ist.
USBDEVICE_PURGEIO

Die USBDEVICE_PURGEIO-Struktur enthält den Griff für den USB-Hub (Universal Serial Bus) oder das Gerät, für das E/A gelöscht werden soll.
USBDEVICE_RESET

Enthält Parameter für eine Anforderung zum Zurücksetzen des angegebenen Geräts. Diese Struktur wird von UCX in Anforderungsparametern (Parameters.Others.Arg1) eines Frameworkanforderungsobjekts der EVT_UCX_USBDEVICE_RESET Rückruffunktion übergeben.
USBDEVICE_STARTIO

Enthält ein Handle für den USB-Hub (Universal Serial Bus), auf dem die Datenübertragung gestartet werden soll.
USBDEVICE_TREE_PURGEIO

Diese Struktur stellt das Handle für die USB-Gerätestruktur (Universal Serial Bus) bereit, für die E/A zu bereinigen.
USBDEVICE_UPDATE

Wird von UCX übergeben, um das angegebene Gerät zu aktualisieren. Diese Struktur befindet sich in den Anforderungsparametern (Parameters.Others.Arg1) eines Frameworkanforderungsobjekts, das in der EVT_UCX_USBDEVICE_UPDATE Rückruffunktion übergeben wird.
USBDEVICE_UPDATE_20_HARDWARE_LPM_PARAMETERS

Enthält Parameter für eine Anforderung zum Aktualisieren der USB 2.0-Link-Energieverwaltung (LPM). UCX übergibt diese Struktur in der EVT_UCX_USBDEVICE_UPDATE Rückruffunktion.
USBDEVICE_UPDATE_FAILURE_FLAGS

Die Flags, die vom Clienttreiber in der EVT_UCX_USBDEVICE_UPDATE Rückruffunktion festgelegt werden. Geben Sie ggf. Fehler an, die beim Aktualisieren des Geräts aufgetreten sind.
USBDEVICE_UPDATE_FLAGS

Enthält von UCX festgelegte Anforderungsflags, die in der USBDEVICE_UPDATE-Struktur übergeben werden, wenn UCX die EVT_UCX_USBDEVICE_UPDATE Rückruffunktion des Clienttreibers aufruft.

Enumerationen

 
UCX_USBDEVICE_CHARACTERISTIC_TYPE

Definiert Werte, die den Typ des Gerätemerkmals angeben.
UCX_USBDEVICE_RECOVERY_ACTION

Definiert Werte für FLDR- und PLDR-Triggerrücksetzungen.