IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS IOCTL (usbioctl.h)

Articolo
02/07/2025

Il driver client invia questa richiesta per recuperare le caratteristiche di trasporto.

Codice principale

Buffer di input/output

Il membro AssociatedIrp.SystemBuffer è un puntatore a una struttura di USB_TRANSPORT_CHARACTERISTICS allocata dal chiamante. In input impostare Versione su USB_TRANSPORT_CHARACTERISTICS_VERSION_1. Nell'output versione viene reimpostata su una versione minore o uguale a USB_TRANSPORT_CHARACTERISTICS_VERSION_1; egli rimanenti membri della struttura è pieno di informazioni di trasporto.

Lunghezza del buffer di input/output

Dimensione della struttura USB_TRANSPORT_CHARACTERISTICS.

Blocco di stato

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

Osservazioni

Questa richiesta recupera le caratteristiche di trasporto per decidere un algoritmo per lo streaming. Ad esempio, un driver di visualizzazione può usare le informazioni sulla latenza e sulla larghezza di banda per decidere la selezione del codec.

Queste informazioni potrebbero non essere sempre disponibili. Lo stack di driver USB dipende dal trasporto sottostante per esporre questi valori. Pertanto, il driver client deve disporre di un meccanismo di backup per tali casi in cui la richiesta.

Se il driver client è interessato a conoscere sempre le informazioni più recenti, il driver deve registrarsi per la notifica quando le caratteristiche di trasporto cambiano, mantenere una richiesta in sospeso con lo stack di driver USB e annullare la registrazione quando la notifica non è più necessaria. Il driver può eseguire tutte queste attività inviando queste richieste IOCTL.