IOCTL_INTERNAL_USBFN_GET_INTERFACE_DESCRIPTOR_SET IOCTL (usbfnioctl.h)
類別驅動程式會傳送此要求,以取得裝置上函式的整個USB介面描述元集。
注意 請勿使用此要求來擷取整個裝置的介面描述元集。
主要程序代碼
IRP_MJ_INTERNAL_DEVICE_CONTROL
輸入緩衝區
緩衝區的指標,其中包含 USBFN_INTERFACE_INFO 結構。
輸入緩衝區長度
輸入緩衝區的長度至少 sizeof(USBFN_INTERFACE_INFO)
必須是 。
輸出緩衝區
緩衝區的指標,其中包含 USBFN_INTERFACE_INFO 結構。 USB 函式類別延伸模組 (UFX) 填入整個介面描述元集的結構,包括其端點描述元。
輸出緩衝區長度
輸出緩衝區的長度至少 sizeof(USBFN_INTERFACE_INFO)
必須是 。
狀態區塊
如果要求成功,則UFX) (USB函式類別延伸模組會傳回STATUS_SUCCESS,或NT_SUCCESS (状态) 等於TRUE的另一個狀態值。 否則會傳回狀態值,NT_SUCCESS (状态) 等於 FALSE。
備註
傳送 IOCTL_INTERNAL_USBFN_ACTIVATE_USB_BUS 要求之後,必須傳送此要求。
整個介面描述元的長度是可變的。 類別驅動程式可能需要傳送這個 IOCTL 要求兩次,以取得整個描述元集。
如果整個描述元集的長度大於指定的輸出緩衝區長度,UFX 會將 USBFN_INTERFACE_INFO 的 Size 成員設定為實際的緩衝區長度,並讓要求失敗並STATUS_BUFFER_TOO_SMALL。 然後,驅動程式必須配置 Size 所指定長度的輸出緩衝區,然後重新傳送要求。
規格需求
需求 | 值 |
---|---|
標頭 | usbfnioctl.h |