IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS IOCTL (usbioctl.h)

Articolo
08/07/2023

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

Codice principale

Input/Buffer di output

Il membro AssociatedIrp.SystemBuffer è un puntatore a una struttura USB_TRANSPORT_CHARACTERISTICS allocata dal chiamante. In input impostare Versione su USB_TRANSPORT_CHARACTERISTICS_VERSION_1. Nella versione di output viene reimpostata una versione minore o uguale a USB_TRANSPORT_CHARACTERISTICS_VERSION_1; i membri rimanenti della struttura vengono riempiti con le informazioni sui trasporti.

Lunghezza del buffer di input/output

Dimensione della struttura USB_TRANSPORT_CHARACTERISTICS .

Blocco dello stato

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

Commenti

Questa richiesta recupera le caratteristiche di trasporto da decidere su 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 le informazioni più recenti in ogni momento, il driver deve registrare per la notifica quando cambiano le caratteristiche del trasporto, 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.

Requisiti

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