IOCTL_USB_NOTIFY_ON_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)

Article
02/07/2025

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 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 de IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE précédente. En sortie, la structure est remplie avec les informations les plus récentes sur le type d’informations pour lequel l’appelant.

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

Taille de la structure USB_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION.

Bloc d’état

> IoStatus.Status est défini sur STATUS_SUCCESS si la requête réussit. Sinon, 'état indique la condition d’erreur appropriée en tant que code NTSTATUS.

Remarques

Cette demande est conservée en attente par la pile de pilotes USB jusqu’à ce qu’une modification des caractéristiques de transport pour lesquelles l’appelant s’est inscrit. Une fois cette demande terminée, la pile de pilotes USB retourne les informations dans la mémoire tampon de sortie.