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. |
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für