IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES IOCTL (usbioctl.h)
La richiesta di controllo I /O IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES recupera gli attributi della porta estesa da Microsoft per una porta specifica.
IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES è una richiesta di controllo di I/O in modalità utente. Questa richiesta è destinata al dispositivo hub USB (GUID_DEVINTERFACE_USB_HUB).
Codice principale
Buffer di input
Il membro AssociatedIrp.SystemBuffer punta a una struttura USB_NODE_CONNECTION_ATTRIBUTES allocata dall'utente. In input, il chiamante specifica il numero di porta nel membro ConnectionIndex di una struttura USB_NODE_CONNECTION_ATTRIBUTES .
Lunghezza del buffer di input
Dimensione di una struttura USB_NODE_CONNECTION_ATTRIBUTES .
Buffer di output
Nell'output la struttura USB_NODE_CONNECTION_ATTRIBUTES in AssociatedIrp.SystemBuffer descrive gli attributi della porta estesa da Microsoft per la porta. Nota Per Windows Vista, Windows Server 2008 e Windows 7, il campo Attributi porta estesa microsoft è impostato su zero.
Per Windows XP e Windows Server 2003, l'attributo di porta estesa microsoft potrebbe essere impostato su USB_PORTATTR_NO_OVERCURRENT_UI. Questo valore indica che l'interfaccia utente verrà nascosta quando si verifica una simultanea sulla porta.
Lunghezza del buffer di output
Parameters.DeviceIoControl.OutputBufferLength indica le dimensioni, in byte, dei dati restituiti in SystemBuffer.
Blocco dello stato
Lo stack USB imposta Irp-IoStatus.Status> su STATUS_SUCCESS se la richiesta ha esito positivo. In caso contrario, lo stack USB imposta status sulla condizione di errore appropriata, ad esempio STATUS_INVALID_PARAMETER o STATUS_INSUFFICIENT_RESOURCES. Se l'hub non è stato avviato o non è funzionante, la richiesta restituisce STATUS_UNSUCCESSFUL.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP, Windows Server 2003 e versioni successive. |
| Intestazione | usbioctl.h (include Usbioctl.h) |