IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)

Article
02/26/2024

Cette demande s’inscrit pour les notifications concernant les modifications apportées aux caractéristiques de transport.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d’entrée/sortie

Le membre AssociatedIrp.SystemBuffer est un pointeur vers une structure USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION . Lors de l’entrée, le pilote client peut spécifier le type de modifications de notification qui intéressent le pilote en définissant les indicateurs dans le membre ChangeNotificationInputFlags .

À la sortie, la structure est remplie avec le handle d’inscription et les valeurs initiales des caractéristiques de transport.

Longueur de la mémoire tampon d’entrée/sortie

Taille de la structure USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION .

Bloc d’état

Irp->IoStatus.Status est défini sur STATUS_SUCCESS si la demande réussit. Sinon, Status indique la condition d’erreur appropriée en tant que code NTSTATUS .

Remarques

Les caractéristiques de transport des supports MA-USB peuvent varier considérablement au fil du temps. Si le plongeur client souhaite connaître les dernières informations à tout moment, le conducteur doit s’inscrire pour la notification en envoyant la demande.

Cette demande peut être envoyée par une application en mode utilisateur, un pilote UMDF ou un pilote KMDF. La pile de pilotes USB vérifie la présence d’un handle d’inscription obsolète et incorrect. Si la demande est reçue sur un handle avant l’inscription et après la désinscription, la pile de pilotes échoue.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1709
Serveur minimal pris en charge	Windows Server 2016
En-tête	usbioctl.h
IRQL	<=DISPATCH_LEVEL