IOCTL_USB_NOTIFY_ON_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)

Article
02/27/2024

Cette demande informe l’appelant de la modification des caractéristiques de transport.

Code principal

Mémoire tampon d’entrée/sortie

Le membre AssociatedIrp.SystemBuffer est un pointeur vers une structure de USB_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION allouée par l’appelant. Lors de l’entrée, l’appelant transmet le handle d’inscription récupéré dans la demande IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE précédente. Lors de la sortie, la structure est remplie avec les informations les plus récentes sur le type d’informations pour lesquelles l’appelant.

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

Taille de la structure USB_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION .

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

Cette requête est conservée en attente par la pile de pilotes USB jusqu’à ce qu’un changement soit apporté aux caractéristiques de transport pour lesquelles l’appelant s’est inscrit. À l’issue de cette demande, la pile de pilotes USB retourne les informations dans la mémoire tampon de sortie.

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