_URB_CONTROL_VENDOR_OR_CLASS_REQUEST結構 (usb.h)
USB 用戶端驅動程式會使用 _URB_CONTROL_VENDOR_OR_CLASS_REQUEST 結構,向裝置、介面、連接點或其他裝置定義的目標發出廠商或類別特定的命令。
語法
struct _URB_CONTROL_VENDOR_OR_CLASS_REQUEST {
struct _URB_HEADER Hdr;
PVOID Reserved;
ULONG TransferFlags;
ULONG TransferBufferLength;
PVOID TransferBuffer;
PMDL TransferBufferMDL;
struct _URB *UrbLink;
struct _URB_HCD_AREA hca;
UCHAR RequestTypeReservedBits;
UCHAR Request;
USHORT Value;
USHORT Index;
USHORT Reserved1;
};
成員
Hdr
指定 URB 標頭資訊的 _URB_HEADER 結構的指標。
Hdr.Function 必須是URB_FUNCTION_CLASS_XXX或URB_FUNCTION_VENDOR_XXX GET_STATUS之一,而且 Hdr.Length 必須是 sizeof(_URB_CONTROL_VENDOR_OR_CLASS_REQUEST)
。
Reserved
TransferFlags
指定下列旗標的零、一或組合:
價值 | 意義 |
---|---|
|
設定為向裝置要求數據。 若要將數據傳輸到裝置,此旗標必須清楚。 如果管道是中斷傳輸管道,則必須設定旗標。 |
|
設定為指示主機控制器在從裝置收到比端點封包大小上限短的封包時,不要傳回錯誤。 端點的封包大小上限會在預設控制端點 USB_DEVICE_DESCRIPTOR 結構 (裝置描述元) 的 bMaxPacketSize0 成員中報告。 針對非預設控制端點,封包大小上限是在 wMaxPacketSizeUSB_ENDPOINT_DESCRIPTOR 結構的成員中設定的(端點描述元)。
當主機控制器收到長度比控制端點上的 wMaxPacketSize 值短的封包時,行為會依主機控制器的類型而定:
除非同時設定USBD_TRANSFER_DIRECTION_IN,否則不應該設定此旗標。 |
TransferBufferLength
指定 TransferBuffer 中指定的緩衝區長度,以位元組為單位,或 TransferBufferMDL中所述。 主機控制器驅動程式會傳回傳送至這個成員管道或從管道讀取的位元組數目。
TransferBuffer
傳送的常駐緩衝區指標,如果 MDL 是在 transferBufferMDL中提供,則為 NULL。 此緩衝區的內容取決於 TransferFlags的值。 如果指定USBD_TRANSFER_DIRECTION_IN,此緩衝區將會包含從主機控制器驅動程式傳回時從裝置讀取的數據。 否則,此緩衝區會包含驅動程式提供的數據,以傳送至裝置。
TransferBufferMDL
描述常駐緩衝區的 MDL 指標,如果 TransferBuffer中提供緩衝區,則為 NULL。 緩衝區的內容取決於 TransferFlags的值。 如果指定USBD_TRANSFER_DIRECTION_IN,描述的緩衝區將會包含從主機控制器驅動程式傳回時從裝置讀取的數據。 否則,緩衝區會包含驅動程式提供的數據傳輸至裝置。 此 MDL 必須從非分頁集區配置。
UrbLink
保留。 請勿使用。
hca
保留。 請勿使用。
RequestTypeReservedBits
保留。 請勿使用。
Request
指定裝置、介面、連接點或其他裝置定義目標的 USB 或廠商定義要求碼。
Value
指定 要求的特定值,這個值會成為目標USB定義的設定封包的一部分。 這個值是由 要求中使用的程式代碼建立者所定義。
Index
如果要求是用於端點或介面,則指定成功組態要求所傳回的裝置定義索引。 否則,Index 必須是零。
Reserved1
保留。 請勿使用。
言論
驅動程式可以使用 UsbBuildVendorRequest 此 URB 服務例程格式。
此結構的保留成員必須視為不透明,並保留供系統使用。
要求
要求 | 價值 |
---|---|
標頭 | usb.h (包括 Usb.h) |