en-tête usbioctl.h

Cet en-tête est utilisé par usbref. Pour plus d'informations, consultez les pages suivantes :

• Universal Serial Bus (USB)

usbioctl.h contient les interfaces de programmation suivantes :

IOCTLs

IOCTL_GET_HCD_DRIVERKEY_NAME La demande de contrôle d’E/S IOCTL_GET_HCD_DRIVERKEY_NAME récupère le nom de clé du pilote dans le Registre pour un pilote de contrôleur hôte USB.
IOCTL_INTERNAL_USB_CYCLE_PORT La demande d’E/S IOCTL_INTERNAL_USB_CYCLE_PORT simule un appareil débranché et rebranché sur le port associé à l’AOP.
IOCTL_INTERNAL_USB_ENABLE_PORT Le IOCTL_INTERNAL_USB_ENABLE_PORT IOCTL a été déprécié. Ne pas utiliser.
IOCTL_INTERNAL_USB_GET_BUS_INFO La demande d’E/S IOCTL_INTERNAL_USB_GET_BUS_INFO interroge le pilote de bus pour obtenir certaines informations de bus.
IOCTL_INTERNAL_USB_GET_BUSGUID_INFO Le IOCTL_INTERNAL_USB_GET_BUSGUID_INFO IOCTL a été déprécié. Ne pas utiliser.
IOCTL_INTERNAL_USB_GET_CONTROLLER_NAME La demande d’E/S IOCTL_INTERNAL_USB_GET_CONTROLLER_NAME interroge le pilote de bus pour le nom du périphérique du contrôleur hôte USB.
IOCTL_INTERNAL_USB_GET_DEVICE_CONFIG_INFO La demande d’E/S IOCTL_INTERNAL_USB_GET_DEVICE_CONFIG_INFO retourne des informations sur un périphérique USB et le hub auquel il est attaché.
IOCTL_INTERNAL_USB_GET_DEVICE_HANDLE Le IOCTL_INTERNAL_USB_GET_DEVICE_HANDLE IOCTL est utilisé par le pilote du hub USB. Ne pas utiliser.
IOCTL_INTERNAL_USB_GET_DEVICE_HANDLE_EX Le IOCTL_INTERNAL_USB_GET_DEVICE_HANDLE_EX IOCTL est utilisé par le pilote du hub USB. Ne pas utiliser.
IOCTL_INTERNAL_USB_GET_HUB_COUNT Le IOCTL_INTERNAL_USB_GET_HUB_COUNT IOCTL est utilisé par le pilote du hub USB. Ne pas utiliser.
IOCTL_INTERNAL_USB_GET_HUB_NAME La demande d’E/S IOCTL_INTERNAL_USB_GET_HUB_NAME est utilisée par les pilotes pour récupérer le nom symbolique UNICODE de l’AOP cible si l’AOP est destiné à un hub.
IOCTL_INTERNAL_USB_GET_PARENT_HUB_INFO Le IOCTL_INTERNAL_USB_GET_PARENT_HUB_INFO est utilisé par le pilote du hub USB. Ne pas utiliser.
IOCTL_INTERNAL_USB_GET_PORT_STATUS La demande d’E/S IOCTL_INTERNAL_USB_GET_PORT_STATUS interroge le status de l’AOP. IOCTL_INTERNAL_USB_GET_PORT_STATUS est une demande de contrôle d’E/S en mode noyau. Cette requête cible l’AOP du hub USB. Ce IOCTL doit être envoyé à IRQL = PASSIVE_LEVEL.
IOCTL_INTERNAL_USB_GET_ROOTHUB_PDO Le IOCTL_INTERNAL_USB_GET_ROOTHUB_PDO IOCTL est utilisé par le pilote du hub USB. Ne pas utiliser.
IOCTL_INTERNAL_USB_GET_TOPOLOGY_ADDRESS La demande d’E/S IOCTL_INTERNAL_USB_GET_TOPOLOGY_ADDRESS renvoie des informations sur le contrôleur hôte auquel le périphérique USB est attaché et l’emplacement de l’appareil dans l’arborescence du périphérique USB.
IOCTL_INTERNAL_USB_GET_TT_DEVICE_HANDLE Le IOCTL_INTERNAL_USB_GET_TT_DEVICE_HANDLE est utilisé par le pilote du hub USB. Ne pas utiliser.
IOCTL_INTERNAL_USB_NOTIFY_IDLE_READY Le IOCTL_INTERNAL_USB_NOTIFY_IDLE_READY IOCTL est utilisé par le pilote du hub USB. Ne pas utiliser.
IOCTL_INTERNAL_USB_RECORD_FAILURE Le IOCTL_INTERNAL_USB_RECORD_FAILURE IOCTL est utilisé par le pilote du hub USB. Ne pas utiliser.
IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE La requête d’E/S IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE inscrit le pilote d’un périphérique multi-fonction USB (pilote composite) avec la pile de pilotes USB sous-jacente.
IOCTL_INTERNAL_USB_REQ_GLOBAL_RESUME Le IOCTL_INTERNAL_USB_REQ_GLOBAL_RESUME IOCTL est utilisé par le pilote du hub USB. Ne pas utiliser.
IOCTL_INTERNAL_USB_REQ_GLOBAL_SUSPEND Le IOCTL_INTERNAL_USB_REQ_GLOBAL_SUSPEND IOCTL est utilisé par le pilote du hub USB. Ne pas utiliser.
IOCTL_INTERNAL_USB_REQUEST_REMOTE_WAKE_NOTIFICATION La demande d’E/S IOCTL_INTERNAL_USB_REQUEST_REMOTE_WAKE_NOTIFICATION est envoyée par le pilote d’un périphérique multi-fonction USB (Universal Serial Bus) (pilote composite) pour demander des notifications de mise en éveil à distance à partir d’une fonction spécifique de l’appareil.
IOCTL_INTERNAL_USB_RESET_PORT La demande de contrôle d’E/S IOCTL_INTERNAL_USB_RESET_PORT est utilisée par un pilote pour réinitialiser le port amont de l’appareil qu’il gère.
IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION La IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION demande d’E/S est utilisée par les pilotes pour informer le pilote de bus USB qu’un appareil est inactif et peut être suspendu.
IOCTL_INTERNAL_USB_SUBMIT_URB La demande de contrôle d’E/S IOCTL_INTERNAL_USB_SUBMIT_URB est utilisée par les pilotes pour envoyer un URB au pilote de bus. IOCTL_INTERNAL_USB_SUBMIT_URB est une demande de contrôle d’E/S en mode noyau. Cette requête cible l’AOP du hub USB.
IOCTL_INTERNAL_USB_UNREGISTER_COMPOSITE_DEVICE La demande d’E/S IOCTL_INTERNAL_USB_UNREGISTER_COMPOSITE_DEVICE annule l’inscription du pilote d’un périphérique multi-fonction USB (pilote composite) et libère toutes les ressources associées à l’inscription.
IOCTL_USB_DIAG_IGNORE_HUBS_OFF Le contrôle d’E/S IOCTL_USB_DIAG_IGNORE_HUBS_OFF a été déprécié. Ne pas utiliser.
IOCTL_USB_DIAG_IGNORE_HUBS_ON Le contrôle d’E/S IOCTL_USB_DIAG_IGNORE_HUBS_ON a été déconseillé. Ne pas utiliser.
IOCTL_USB_DIAGNOSTIC_MODE_OFF Le contrôle d’E/S IOCTL_USB_DIAGNOSTIC_MODE_OFF a été déprécié. Ne pas utiliser.
IOCTL_USB_DIAGNOSTIC_MODE_ON Le contrôle d’E/S IOCTL_USB_DIAGNOSTIC_MODE_ON a été déconseillé. Ne pas utiliser.
IOCTL_USB_GET_DESCRIPTOR_FROM_NODE_CONNECTION La demande de contrôle d’E/S IOCTL_USB_GET_DESCRIPTOR_FROM_NODE_CONNECTION récupère un ou plusieurs descripteurs pour l’appareil associé à l’index de port indiqué. IOCTL_USB_GET_DESCRIPTOR_FROM_NODE_CONNECTION est une demande de contrôle d’E/S en mode utilisateur.
IOCTL_USB_GET_DEVICE_CHARACTERISTICS Le pilote client envoie cette demande pour déterminer les caractéristiques générales d’un périphérique USB, telles que les délais d’envoi et de réception maximums pour toute demande.
IOCTL_USB_GET_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC La fonction IOCTL IOCTL_USB_GET_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC obtient la valeur QPC (System Query Performance Counter) pour une image et un microframe spécifiques.
IOCTL_USB_GET_HUB_CAPABILITIES La demande de contrôle d’E/S IOCTL_USB_GET_HUB_CAPABILITIES récupère les fonctionnalités d’un hub USB.
IOCTL_USB_GET_HUB_CAPABILITIES_EX La demande de contrôle d’E/S IOCTL_USB_GET_HUB_CAPABILITIES_EX récupère les fonctionnalités d’un hub USB. IOCTL_USB_GET_HUB_CAPABILITIES_EX est une demande de contrôle d’E/S en mode utilisateur. Cette requête cible le périphérique hub USB (GUID_DEVINTERFACE_USB_HUB).
IOCTL_USB_GET_HUB_INFORMATION_EX La demande de contrôle d’E/S IOCTL_USB_GET_HUB_INFORMATION_EX est envoyée par une application pour récupérer des informations sur un hub USB dans une structure de USB_HUB_INFORMATION_EX. La requête récupère le numéro de port le plus élevé sur le hub.
IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES La demande de contrôle d’E/S IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES récupère les attributs de port étendus par Microsoft pour un port spécifique.
IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME La demande de contrôle d’E/S IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME récupère le nom de clé de registre du pilote associé au périphérique connecté au port indiqué.
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION La demande IOCTL_USB_GET_NODE_CONNECTION_INFORMATION récupère des informations sur le port USB indiqué et le périphérique attaché au port, le cas échéant. Les pilotes clients doivent envoyer ce IOCTL à un IRQL de PASSIVE_LEVEL. IOCTL_USB_GET_NODE_CONNECTION_INFORMATION est une demande de contrôle d’E/S en mode utilisateur. Cette requête cible le périphérique hub USB (GUID_DEVINTERFACE_USB_HUB). N’envoyez pas cette demande au hub racine.
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX La demande IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX récupère des informations sur un port USB et l’appareil qui est attaché au port, le cas échéant. Les pilotes clients doivent envoyer ce IOCTL à un IRQL de PASSIVE_LEVEL. IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX est une demande de contrôle d’E/S en mode utilisateur. Cette requête cible le périphérique hub USB (GUID_DEVINTERFACE_USB_HUB). N’envoyez pas cette demande au hub racine.
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX_V2 Le contrôle d’E/S IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX_V2 est envoyé par une application pour récupérer des informations sur les protocoles pris en charge par un port USB particulier sur un hub. La requête récupère également la fonctionnalité de vitesse du port.
IOCTL_USB_GET_NODE_CONNECTION_NAME La demande de contrôle d’E/S IOCTL_USB_GET_NODE_CONNECTION_NAME est utilisée avec la structure USB_NODE_CONNECTION_NAME pour récupérer le nom de liaison symbolique du hub attaché au port en aval. IOCTL_USB_GET_NODE_CONNECTION_NAME est une demande de contrôle d’E/S en mode utilisateur. Cette requête cible le périphérique hub USB (GUID_DEVINTERFACE_USB_HUB).
IOCTL_USB_GET_NODE_INFORMATION La demande de contrôle d’E/S IOCTL_USB_GET_NODE_INFORMATION est utilisée avec la structure USB_NODE_INFORMATION pour récupérer des informations sur un appareil parent. IOCTL_USB_GET_NODE_INFORMATION est une demande de contrôle d’E/S en mode utilisateur.
IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES La demande de contrôle d’E/S IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES est envoyée par une application pour récupérer des informations sur un port spécifique sur un hub USB.
IOCTL_USB_GET_ROOT_HUB_NAME La demande de contrôle d’E/S IOCTL_USB_GET_ROOT_HUB_NAME est utilisée avec la structure USB_ROOT_HUB_NAME pour récupérer le nom de lien symbolique du hub racine. IOCTL_USB_GET_ROOT_HUB_NAME est une demande de contrôle d’E/S en mode utilisateur.
IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS Le pilote client envoie cette demande pour récupérer les caractéristiques de transport.
IOCTL_USB_HCD_DISABLE_PORT La IOCTL_USB_HCD_DISABLE_PORT IOCTL a été dépréciée. Ne pas utiliser.
IOCTL_USB_HCD_ENABLE_PORT La IOCTL_USB_HCD_ENABLE_PORT IOCTL a été dépréciée. Ne pas utiliser.
IOCTL_USB_HCD_GET_STATS_1 La IOCTL_USB_HCD_GET_STATS_1 IOCTL a été dépréciée. Ne pas utiliser.
IOCTL_USB_HCD_GET_STATS_2 Le IOCTL_USB_HCD_GET_STATS_2 IOCTL a été déprécié. Ne pas utiliser.
IOCTL_USB_HUB_CYCLE_PORT Le IOCTL_USB_HUB_CYCLE_PORT demande de contrôle d’E/S met sous tension le port associé à l’AOP qui reçoit la demande.
IOCTL_USB_NOTIFY_ON_TRANSPORT_CHARACTERISTICS_CHANGE Cette demande informe l’appelant de la modification des caractéristiques de transport.
IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE Cette demande s’inscrit pour recevoir des notifications sur les modifications apportées aux caractéristiques de transport.
IOCTL_USB_RESET_HUB La IOCTL_USB_RESET_HUB IOCTL est utilisée par la pile de pilotes USB. Ne pas utiliser.
IOCTL_USB_START_TRACKING_FOR_TIME_SYNC Cette demande inscrit l’appelant avec la pile de pilotes USB pour les services de synchronisation de temps.
IOCTL_USB_STOP_TRACKING_FOR_TIME_SYNC Cette requête annule l’inscription de l’appelant auprès de la pile de pilotes USB pour les services de synchronisation de temps.
IOCTL_USB_UNREGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE Cette demande annule l’inscription de l’appelant pour recevoir des notifications sur les modifications des caractéristiques de transport.

Structures

HUB_DEVICE_CONFIG_INFO La structure HUB_DEVICE_CONFIG_INFO est utilisée conjointement avec l’IOCTL en mode noyau, IOCTL_INTERNAL_USB_GET_DEVICE_CONFIG_INFO pour demander à signaler des informations sur un périphérique USB et le hub auquel l’appareil est attaché.
USB_BUS_NOTIFICATION En savoir plus sur : structure _USB_BUS_NOTIFICATION
USB_CYCLE_PORT_PARAMS La structure USB_CYCLE_PORT_PARAMS est utilisée avec la demande de contrôle d’E/S IOCTL_USB_HUB_CYCLE_PORT pour mettre sous tension le port associé à l’AOP qui reçoit la demande.
USB_DESCRIPTOR_REQUEST La structure USB_DESCRIPTOR_REQUEST est utilisée avec la demande de contrôle d’E/S IOCTL_USB_GET_DESCRIPTOR_FROM_NODE_CONNECTION pour récupérer un ou plusieurs descripteurs pour l’appareil associé à l’index de connexion indiqué.
USB_DEVICE_CHARACTERISTICS Contient des informations sur les caractéristiques du périphérique USB, telles que les délais d’envoi et de réception maximums pour toute demande. Cette structure est utilisée dans la demande IOCTL_USB_GET_DEVICE_CHARACTERISTICS.
USB_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC_INFORMATION Stocke les numéros de trame et de microframe, ainsi que les valeurs QPC système calculées. Cette structure est utilisée dans la demande IOCTL_USB_GET_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC.
USB_HCD_DRIVERKEY_NAME La structure USB_HCD_DRIVERKEY_NAME est utilisée avec la demande de contrôle d’E/S IOCTL_GET_HCD_DRIVERKEY_NAME pour récupérer la clé de pilote dans le Registre pour le pilote du contrôleur hôte USB.
USB_HUB_CAP_FLAGS La structure USB_HUB_CAP_FLAGS est utilisée pour signaler les fonctionnalités d’un hub.
USB_HUB_CAPABILITIES La structure USB_HUB_CAPABILITIES a été déconseillée. Utilisez USB_HUB_CAPABILITIES_EX à la place.
USB_HUB_CAPABILITIES_EX La structure USB_HUB_CAPABILITIES_EX est utilisée avec la demande de contrôle d’E/S IOCTL_USB_GET_HUB_CAPABILITIES pour récupérer les fonctionnalités d’un hub USB particulier.
USB_HUB_INFORMATION La structure USB_HUB_INFORMATION contient des informations sur un hub.
USB_HUB_INFORMATION_EX La structure USB_HUB_INFORMATION_EX est utilisée avec la demande de contrôle d’E/S IOCTL_USB_GET_HUB_INFORMATION_EX pour récupérer des informations sur un hub USB (Universal Serial Bus).
USB_HUB_NAME La structure USB_HUB_NAME stocke le nom symbolique de l’appareil du hub.
USB_ID_STRING La structure USB_ID_STRING est utilisée pour stocker une chaîne ou plusieurs chaînes.
USB_MI_PARENT_INFORMATION La structure USB_MI_PARENT_INFORMATION contient des informations sur un appareil composite.
USB_NODE_CONNECTION_ATTRIBUTES La structure USB_NODE_CONNECTION_ATTRIBUTES est utilisée avec la demande de contrôle d’E/S IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES pour récupérer les attributs d’une connexion.
USB_NODE_CONNECTION_DRIVERKEY_NAME La structure USB_NODE_CONNECTION_DRIVERKEY_NAME est utilisée avec la demande de contrôle d’E/S IOCTL_USB_GET_NODE_CONNECTION_DRIVERKEY_NAME pour récupérer le nom de clé de pilote de l’appareil connecté au port indiqué.
USB_NODE_CONNECTION_INFORMATION La structure USB_NODE_CONNECTION_INFORMATION est utilisée avec la demande de IOCTL_USB_GET_NODE_CONNECTION_INFORMATION pour récupérer des informations sur un port USB et un appareil connecté.
USB_NODE_CONNECTION_INFORMATION_EX La structure USB_NODE_CONNECTION_INFORMATION_EX est utilisée conjointement avec la demande de IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX pour obtenir des informations sur la connexion associée au port USB indiqué.
USB_NODE_CONNECTION_INFORMATION_EX_V2 La structure USB_NODE_CONNECTION_INFORMATION_EX_V2 est utilisée avec la demande de contrôle d’E/S IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX_V2 pour récupérer des informations de vitesse sur un périphérique USB (Universal Serial Bus) attaché à un port particulier.
USB_NODE_CONNECTION_INFORMATION_EX_V2_FLAGS L’union USB_NODE_CONNECTION_INFORMATION_EX_V2_FLAGS est utilisée pour indiquer la vitesse à laquelle un appareil USB 3.0 fonctionne actuellement et s’il peut fonctionner à une vitesse plus élevée, lorsqu’il est attaché à un port particulier.
USB_NODE_CONNECTION_NAME La structure USB_NODE_CONNECTION_NAME est utilisée avec la demande de contrôle d’E/S IOCTL_USB_GET_NODE_CONNECTION_NAME pour récupérer le lien symbolique du hub en aval attaché au port.
USB_NODE_INFORMATION La structure USB_NODE_INFORMATION est utilisée avec la demande de contrôle d’E/S IOCTL_USB_GET_NODE_INFORMATION pour récupérer des informations sur un appareil parent.
USB_PIPE_INFO La structure USB_PIPE_INFO est utilisée conjointement avec la structure USB_NODE_CONNECTION_INFORMATION_EX et la demande IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX pour obtenir des informations sur une connexion et ses canaux associés.
USB_PORT_CONNECTOR_PROPERTIES La structure USB_PORT_CONNECTOR_PROPERTIES est utilisée avec la demande de contrôle d’E/S IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES pour récupérer des informations sur un port sur un hub SuperSpeed particulier.
USB_PORT_PROPERTIES L’union USB_PORT_PROPERTIES est utilisée pour signaler les fonctionnalités d’un port USB (Universal Serial Bus). Les fonctionnalités de port sont récupérées dans la structure USB_PORT_CONNECTOR_PROPERTIES par la demande de contrôle d’E/S IOCTL_USB_GET_PORT_CONNECTOR_PROPERTIES.
USB_PROTOCOLS L’union USB_PROTOCOLS est utilisée pour signaler les protocoles de signalisation USB (Universal Serial Bus) pris en charge par le port.
USB_ROOT_HUB_NAME La structure USB_ROOT_HUB_NAME stocke le nom symbolique de l’appareil du hub racine.
USB_START_TRACKING_FOR_TIME_SYNC_INFORMATION Mémoire tampon d’entrée et de sortie pour la demande IOCTL_USB_START_TRACKING_FOR_TIME_SYNC.
USB_STOP_TRACKING_FOR_TIME_SYNC_INFORMATION Mémoire tampon d’entrée pour la requête IOCTL_USB_STOP_TRACKING_FOR_TIME_SYNC.
USB_TOPOLOGY_ADDRESS La structure USB_TOPOLOGY_ADDRESS est utilisée avec la demande d’E/S IOCTL_INTERNAL_USB_GET_TOPOLOGY_ADDRESS pour récupérer des informations sur l’emplacement d’un périphérique USB dans l’arborescence de périphériques USB.
USB_TRANSPORT_CHARACTERISTICS Stocke les caractéristiques de transport à des moments pertinents. Cette structure est utilisée dans la demande IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS.
USB_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION Contient des informations d’inscription renseignées lorsque la demande de IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE est terminée.
USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION Contient des informations d’inscription pour la demande de IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE.
USB_TRANSPORT_CHARACTERISTICS_CHANGE_UNREGISTRATION Contient des informations d’annulation d’inscription pour la demande de IOCTL_USB_UNREGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE.

Énumérations

USB_CONNECTION_STATUS L’énumérateur USB_CONNECTION_STATUS indique le status de la connexion à un appareil sur un port de hub USB.
USB_HUB_NODE L’énumérateur USB_HUB_NODE indique si un appareil est un hub ou un appareil composite.
USB_HUB_TYPE L’énumération USB_HUB_TYPE définit des constantes qui indiquent le type de hub USB. Le type de hub est récupéré par la demande de contrôle d’E/S IOCTL_USB_GET_HUB_INFORMATION_EX.
USB_NOTIFICATION_TYPE En savoir plus sur : énumération _USB_NOTIFICATION_TYPE