USB_BUS_INTERFACE_USBDI_V3結構 (usbbusif.h)
USB_BUS_INTERFACE_USBDI_V3 結構是由 USB 中樞驅動程式提供,可讓 USB 用戶端直接呼叫中樞驅動程式,而不需要配置 IRP。
語法
typedef struct _USB_BUS_INTERFACE_USBDI_V3 {
USHORT Size;
USHORT Version;
PVOID BusContext;
PINTERFACE_REFERENCE InterfaceReference;
PINTERFACE_DEREFERENCE InterfaceDereference;
PUSB_BUSIFFN_GETUSBDI_VERSION GetUSBDIVersion;
PUSB_BUSIFFN_QUERY_BUS_TIME QueryBusTime;
PUSB_BUSIFFN_SUBMIT_ISO_OUT_URB SubmitIsoOutUrb;
PUSB_BUSIFFN_QUERY_BUS_INFORMATION QueryBusInformation;
PUSB_BUSIFFN_IS_DEVICE_HIGH_SPEED IsDeviceHighSpeed;
PUSB_BUSIFFN_ENUM_LOG_ENTRY EnumLogEntry;
PUSB_BUSIFFN_QUERY_BUS_TIME_EX QueryBusTimeEx;
PUSB_BUSIFFN_QUERY_CONTROLLER_TYPE QueryControllerType;
} USB_BUS_INTERFACE_USBDI_V3, *PUSB_BUS_INTERFACE_USBDI_V3;
成員
Size
指定緩衝區的大小,以位元組為單位來保存介面指標。
Version
表示在輸入時,介面的版本。 這個成員可以接受的值如下。
價值 | 意義 |
---|---|
USB_BUSIF_USBDI_VERSION_0 | 介面的第 0 版。 |
USB_BUSIF_USBDI_VERSION_1 | 介面的第 1 版。 |
USB_BUSIF_USBDI_VERSION_2 | 介面的第 2 版。 |
USB_BUSIF_USBDI_VERSION_3 | 介面的第 3 版。 |
BusContext
包含描述 USB 總線和公開此介面的 USB 總線驅動程式的資訊。 這是呼叫端必須傳遞至介面例程的不透明實體。
InterfaceReference
這個例程的指標會遞增這個介面的參考數目。 如需此例程的詳細資訊,請參閱 InterfaceReference。
InterfaceDereference
遞減這個介面之參考數目的例程指標。 如需此例程的詳細資訊,請參閱 InterfaceDereference。
GetUSBDIVersion
傳回 USB 介面版本號碼的例程指標、定義介面之 USB 規格的版本號碼,以及主控制器功能資訊。 此例程會傳回埠驅動程序支援的最高 USBDI 介面版本。 如需此例程的詳細資訊,請參閱 GetUSBDIVersion。
QueryBusTime
傳回目前 32 位 USB 框架編號的例程指標。 此例程會取代 usbd.sys所提供的 USBD_QueryBusTime 函式。 如需此例程的詳細資訊,請參閱 QueryBusTime。
SubmitIsoOutUrb
保留。 請勿使用。
QueryBusInformation
擷取總線相關信息的例程指標。 傳回的信息取決於 層級 成員的值。 如果 層級 為 0,此例程會傳回總線頻寬資訊。 如果 層級 為 1,則會傳回總線頻寬資訊和主機控制器的符號名稱。 此例程會取代 usbd.sys所提供的 USBD_QueryBusInformation 函式。 如需此例程的詳細資訊,請參閱 QueryBusInformation。
IsDeviceHighSpeed
判斷USB裝置是否以高速運作的例程指標。 如果USB裝置以高速USB 2.0相容裝置運作,此例程會傳回 true TRUE。 否則會傳回 FALSE 。 如需此例程的詳細資訊,請參閱 IsDeviceHighSpeed。
EnumLogEntry
保留。 請勿使用。
QueryBusTimeEx
未實作此例程。
QueryControllerType
傳回 USB 裝置所連結之 USB 主機控制器相關信息的例程指標。 如需此例程的詳細資訊,請參閱 QueryControllerType。
言論
IsDeviceHighSpeed 例程並不表示裝置是否能夠高速作,但實際上是否以高速運作。
此結構中的例程必須在 IRQL >= DISPATCH_LEVEL呼叫。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista 和更新版本的作系統。 |
標頭 | usbbusif.h (包括 Usbbusif.h) |
另請參閱
適用於 USB 用戶端驅動程式的 總線驅動程式介面例程