ucxusbdevice.h, en-tête

Cet en-tête est utilisé pour écrire un pilote de contrôleur hôte USB. L’extension du contrôleur hôte USB est un pilote fourni par le système (Ucx01000.sys). Ce pilote est implémenté en tant qu’extension de classe d’infrastructure à l’aide des interfaces de programmation windows Driver Framework. Le pilote du contrôleur hôte sert de pilote client à cette extension de classe. Alors qu’un pilote de contrôleur hôte gère les opérations matérielles et les événements, la gestion de l’alimentation et les événements PnP, UCX sert d’interface abstraite qui met en file d’attente les demandes au pilote du contrôleur hôte et effectue d’autres tâches.

N’incluez pas directement cet en-tête. Au lieu de cela, incluez Ucxclass.h

Pour plus d'informations, consultez les pages suivantes :

• Développement de pilotes Windows pour les contrôleurs hôtes USB
• Universal Serial Bus (USB)

ucxusbdevice.h contient les interfaces de programmation suivantes :

Fonctions

UCX_USBDEVICE_EVENT_CALLBACKS_INIT Initialise une structure UCX_USBDEVICE_EVENT_CALLBACKS avec les pointeurs de fonction vers les fonctions de rappel du pilote client.
UcxUsbDeviceCreate Crée un objet de périphérique USB sur le contrôleur spécifié.
UcxUsbDeviceInitSetEventCallbacks Initialise une structure UCXUSBDEVICE_INIT avec les fonctions de rappel d’événement du pilote client.
UcxUsbDeviceRemoteWakeNotification Avertit UCX qu’un signal de sortie de veille à distance de l’appareil est reçu.

Fonctions de rappel

EVT_UCX_USBDEVICE_ADDRESS Implémentation du pilote client qu’UCX appelle pour traiter le périphérique USB.
EVT_UCX_USBDEVICE_DEFAULT_ENDPOINT_ADD Implémentation du pilote client qu’UCX appelle pour ajouter un nouveau point de terminaison par défaut pour un périphérique USB.
EVT_UCX_USBDEVICE_DISABLE Implémentation du pilote client qu’UCX appelle pour libérer les ressources du contrôleur associées à l’appareil et à son point de terminaison par défaut.
EVT_UCX_USBDEVICE_ENABLE Implémentation du pilote client qu’UCX appelle pour programmer des informations sur l’appareil et son point de terminaison de contrôle par défaut dans le contrôleur.
EVT_UCX_USBDEVICE_ENDPOINT_ADD Implémentation du pilote client qu’UCX appelle pour ajouter un nouveau point de terminaison pour un périphérique USB.
EVT_UCX_USBDEVICE_ENDPOINTS_CONFIGURE Implémentation du pilote client qu’UCX appelle pour configurer des points de terminaison dans le contrôleur.
EVT_UCX_USBDEVICE_GET_CHARACTERISTIC UCX appelle ce rappel pour récupérer les caractéristiques de l’appareil.
EVT_UCX_USBDEVICE_HUB_INFO Implémentation du pilote client qu’UCX appelle pour récupérer les propriétés du hub.
EVT_UCX_USBDEVICE_RESET Implémentation du pilote client qu’UCX appelle lorsque le port auquel l’appareil est attaché est réinitialisé.
EVT_UCX_USBDEVICE_RESUME UCX appelle cette fonction de rappel pour reprendre l’état de suspension d’un appareil.
EVT_UCX_USBDEVICE_SUSPEND UCX appelle cette fonction de rappel pour envoyer un état de suspension d’appareil.
EVT_UCX_USBDEVICE_UPDATE Implémentation du pilote client qu’UCX appelle pour mettre à jour les propriétés de l’appareil.

Structures

ADDRESS0_OWNERSHIP_ACQUIRE Contient les paramètres de configuration de l’appareil.
UCX_USBDEVICE_CHARACTERISTIC Stocke les caractéristiques d’un appareil.
UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY Découvrez comment UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY stocke les valeurs de délai de chemin de transfert isochroneuses.
UCX_USBDEVICE_EVENT_CALLBACKS Cette structure fournit une liste des fonctions de rappel d’événement de périphérique USB UCX.
UCXUSBDEVICE_INFO Contient des informations sur le périphérique USB. Cette structure est passée par UCX dans la fonction de rappel d’événement EVT_UCX_CONTROLLER_USBDEVICE_ADD.
USB_DEVICE_PORT_PATH Contient le chemin de port d’un périphérique USB.
USBDEVICE_ABORTIO Contient un handle pour le hub USB (Universal Serial Bus) ou l’appareil pour lequel abandonner les transferts de données.
USBDEVICE_ADDRESS Contient les paramètres d’une demande de transition de l’appareil spécifié vers l’état Addressed. Cette structure est transmise par UCX dans les paramètres de requête (Parameters.Others.Arg1) d’un objet de requête d’infrastructure de la fonction de rappel EVT_UCX_USBDEVICE_ADDRESS.
USBDEVICE_DISABLE Contient les paramètres d’une demande de désactivation de l’appareil spécifié. Cette structure est transmise par UCX dans les paramètres de requête (Parameters.Others.Arg1) d’un objet de requête d’infrastructure de la fonction de rappel EVT_UCX_USBDEVICE_DISABLE.
USBDEVICE_ENABLE Contient les paramètres d’une demande d’activation de l’appareil spécifié. Cette structure est transmise par UCX dans les paramètres de requête (Parameters.Others.Arg1) d’un objet de requête d’infrastructure de la fonction de rappel EVT_UCX_USBDEVICE_ENABLE.
USBDEVICE_ENABLE_FAILURE_FLAGS Indicateurs définis par le pilote client dans la fonction de rappel EVT_UCX_USBDEVICE_ENABLE. Indiquez les erreurs, le cas échéant, qui ont pu se produire lors de l’activation de l’appareil.
USBDEVICE_HUB_INFO Contient les paramètres d’une demande d’obtention d’informations sur le hub spécifié. Cette structure est transmise par UCX dans les paramètres de requête (Parameters.Others.Arg1) d’un objet de requête d’infrastructure de la fonction de rappel EVT_UCX_USBDEVICE_HUB_INFO.
USBDEVICE_MGMT_HEADER Cette structure fournit un handle pour le hub USB (Universal Serial Bus) ou l’appareil physiquement connecté au bus.
USBDEVICE_PURGEIO La structure USBDEVICE_PURGEIO contient le handle du hub usb (Universal Serial Bus) ou du périphérique pour lequel purger les E/S.
USBDEVICE_RESET Contient les paramètres d’une demande de réinitialisation de l’appareil spécifié. Cette structure est transmise par UCX dans les paramètres de requête (Parameters.Others.Arg1) d’un objet de requête d’infrastructure de la fonction de rappel EVT_UCX_USBDEVICE_RESET.
USBDEVICE_STARTIO Contient un handle pour le hub usb (Universal Serial Bus) ou l’appareil sur lequel démarrer le transfert de données.
USBDEVICE_TREE_PURGEIO Cette structure fournit la poignée de l’arborescence de périphériques USB (Universal Serial Bus) pour laquelle purger les E/S.
USBDEVICE_UPDATE Passé par UCX pour mettre à jour l’appareil spécifié. Cette structure se trouve dans les paramètres de requête (Parameters.Others.Arg1) d’un objet de requête d’infrastructure passé dans la fonction de rappel EVT_UCX_USBDEVICE_UPDATE.
USBDEVICE_UPDATE_20_HARDWARE_LPM_PARAMETERS Contient les paramètres d’une demande de mise à jour de la gestion de l’alimentation des liaisons USB 2.0 (LPM). UCX transmet cette structure dans la fonction de rappel EVT_UCX_USBDEVICE_UPDATE.
USBDEVICE_UPDATE_FAILURE_FLAGS Indicateurs définis par le pilote client dans la fonction de rappel EVT_UCX_USBDEVICE_UPDATE. Indiquez les erreurs, le cas échéant, qui ont pu se produire lors de la mise à jour de l’appareil.
USBDEVICE_UPDATE_FLAGS Contient des indicateurs de requête définis par UCX qui sont transmis dans la structure USBDEVICE_UPDATE quand UCX appelle la fonction de rappel EVT_UCX_USBDEVICE_UPDATE du pilote client.

Énumérations

UCX_USBDEVICE_CHARACTERISTIC_TYPE Définit des valeurs qui indiquent le type de caractéristique d’appareil.
UCX_USBDEVICE_RECOVERY_ACTION Définit des valeurs pour les réinitialisations des déclencheurs FLDR et PLDR.