IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)

Articolo
02/26/2024

Questa richiesta registra le notifiche sulle modifiche apportate alle caratteristiche del trasporto.

Codice principale

Input/Buffer di output

Il membro AssociatedIrp.SystemBuffer è un puntatore a una struttura USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION . In input, il driver client può specificare il tipo di modifiche di notifica in cui il driver è interessato impostando i flag nel membro ChangeNotificationInputFlags .

In output, la struttura viene riempita con l'handle di registrazione e i valori iniziali delle caratteristiche del trasporto.

Lunghezza del buffer di input/output

Dimensione della struttura USB_TRANSPORT_CHARACTERISTICS_CHANGE_REGISTRATION .

Blocco dello stato

Irp->IoStatus.Status è impostato su STATUS_SUCCESS se la richiesta ha esito positivo. In caso contrario, stato indica la condizione di errore appropriata come codice NTSTATUS .

Commenti

Le caratteristiche di trasporto dei supporti MA-USB possono variare significativamente nel tempo. Se il client diver è interessato a conoscere le informazioni più recenti in ogni momento, il driver deve registrarsi per la notifica inviando la richiesta.

Questa richiesta può essere inviata da un'applicazione in modalità utente, un driver UMDF o un driver KMDF. Lo stack di driver USB verifica la presenza di un handle di registrazione non aggiornato e non valido. Se la richiesta viene ricevuta in un handle prima della registrazione e dopo l'annullamento della registrazione, lo stack di driver ha esito negativo alla richiesta.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1709
Server minimo supportato	Windows Server 2016
Intestazione	usbioctl.h
IRQL	<=DISPATCH_LEVEL