_URB_BULK_OR_INTERRUPT_TRANSFER結構 (usb.h)
_URB_BULK_OR_INTERRUPT_TRANSFER 結構是由USB用戶端驅動程式用來在大量管道或中斷管道上傳送或接收數據。
語法
struct _URB_BULK_OR_INTERRUPT_TRANSFER {
struct _URB_HEADER Hdr;
USBD_PIPE_HANDLE PipeHandle;
ULONG TransferFlags;
ULONG TransferBufferLength;
PVOID TransferBuffer;
PMDL TransferBufferMDL;
struct _URB *UrbLink;
struct _URB_HCD_AREA hca;
};
成員
Hdr
指定 URB 標頭資訊的 _URB_HEADER 結構的指標。
Hdr.Function 必須URB_FUNCTION_BULK_OR_INTERRUPT_TRANSFER,而且 Hdr.Length 必須設定為 sizeof(_URB_BULK_OR_INTERRUPT_TRANSFER)
。
PipeHandle
指定大量或中斷管道的不透明句柄。 當用戶端驅動程式選取具有類型為 URB 的裝置組態 URB_FUNCTION_SELECT_CONFIGURATION時,或當用戶端驅動程式變更具有類型為 URB 且類型為 URB_FUNCTION_SELECT_INTERFACE 的介面設定時,主機控制器驅動程式會傳回此句柄。
TransferFlags
指定下列旗標的零、一或組合:
價值 | 意義 |
---|---|
|
設定為向裝置要求數據。 若要將數據傳輸到裝置,此旗標必須清楚。 |
|
設定為將數據傳輸到裝置。 設定此旗標相當於清除USBD_TRANSFER_DIRECTION_IN旗標。 |
|
設定為指示主機控制器在從裝置收到比端點封包大小上限短的封包時,不要傳回錯誤。 端點的封包大小上限會在 wMaxPacketSizeUSB_ENDPOINT_DESCRIPTOR 結構的成員中報告(端點描述元)。 當主機控制器收到小於 wMaxPacketSize 的封包時,大量或中斷端點上的,主機控制器會立即停止向端點要求數據,並完成傳輸。 如果未設定USBD_SHORT_TRANSFER_OK旗標,主機控制器就會完成傳輸併發生錯誤。
除非同時設定USBD_TRANSFER_DIRECTION_IN,否則不應該設定此旗標。 注意 EHCI 主機控制器上,大量和中斷端點會忽略USBD_SHORT_TRANSFER_OK。 在 EHCI 控制器上傳送短封包並不會導致錯誤狀況。 在UHCI和 OHCI 主機控制器上,如果未針對大量傳輸或中斷傳輸設定USBD_SHORT_TRANSFER_OK,簡短封包傳輸會停止端點,並傳回錯誤碼以進行傳輸。 用戶端驅動程序必須先提交URB_FUNCTION_SYNC_RESET_PIPE_AND_CLEAR_STALL要求,再將傳輸要求提交至端點,以繼續端點。 |
TransferBufferLength
指定 TransferBuffer 中指定的緩衝區長度,以位元組為單位,或 TransferBufferMDL中所述。 主機控制器驅動程式會傳回傳送至這個成員管道或從管道讀取的位元組數目。
TransferBuffer
傳送的常駐緩衝區指標,如果 MDL 是在 transferBufferMDL中提供,則為 NULL。 此緩衝區的內容取決於 TransferFlags的值。 如果指定USBD_TRANSFER_DIRECTION_IN,此緩衝區將會包含從主機控制器驅動程式傳回時從裝置讀取的數據。 否則,此緩衝區會包含驅動程式提供的數據,以傳送至裝置。
TransferBufferMDL
描述常駐緩衝區的 MDL 指標,如果 TransferBuffer中提供緩衝區,則為 NULL。 緩衝區的內容取決於 TransferFlags的值。 如果指定USBD_TRANSFER_DIRECTION_IN,描述的緩衝區將會包含從主機控制器驅動程式傳回時從裝置讀取的數據。 否則,緩衝區會包含驅動程式提供的數據傳輸至裝置。 此 MDL 必須從非分頁集區配置。
UrbLink
保留。 請勿使用。
hca
保留。 請勿使用。
言論
驅動程式可以使用 UsbBuildInterruptOrBulkTransferRequest 服務例程來格式化此 URB。 TransferBuffer 中指定的緩衝區,或 TransferBufferMDL 中所述的緩衝區必須是不可分頁的。
在 URB中,TransferBuffer 和 TransferBufferMDL 參數可以是非 NULL 值。 在此情況下,傳輸緩衝區和 MDL 指向 TransferBuffer,TransferBufferMDL 必須指向相同的緩衝區。
USB 總線驅動程式會在 DISPATCH_LEVEL處理此 URB。
此結構的保留成員必須視為不透明,並保留供系統使用。
要求
要求 | 價值 |
---|---|
標頭 | usb.h (包括 Usb.h) |