usb.h) (_URB_CONTROL_GET_STATUS_REQUEST 結構
USB 用戶端驅動程式會使用_URB_CONTROL_GET_STATUS_REQUEST結構,從裝置、介面、連接點或其他裝置定義的目標擷取狀態。
語法
struct _URB_CONTROL_GET_STATUS_REQUEST {
struct _URB_HEADER Hdr;
PVOID Reserved;
ULONG Reserved0;
ULONG TransferBufferLength;
PVOID TransferBuffer;
PMDL TransferBufferMDL;
struct _URB *UrbLink;
struct _URB_HCD_AREA hca;
UCHAR Reserved1[4];
USHORT Index;
USHORT Reserved2;
};
成員
Hdr
指定 URB 標頭資訊的 _URB_HEADER 結構的指標。 Hdr.Length 必須是 sizeof(_URB_CONTROL_GET_STATUS_REQUEST)
, 而 Hdr.Function 必須是下列其中一個值:
- URB_FUNCTION_GET_STATUS_FROM_DEVICE
- URB_FUNCTION_GET_STATUS_FROM_INTERFACE
- URB_FUNCTION_GET_STATUS_FROM_ENDPOINT
- URB_FUNCTION_GET_STATUS_FROM_OTHER
Reserved
保留的。 請勿使用。
Reserved0
保留的。 請勿使用。
TransferBufferLength
必須是 2。 這個成員會指定 TransferBuffer 中指定的緩衝區長度,以位元組為單位,或在 TransferBufferMDL 中所述。 主機控制器驅動程式會傳回傳送至這個成員中管道或從管道讀取的位元組數目。
TransferBuffer
傳送之駐留緩衝區的指標,如果 TransferBufferMDL 中提供 MDL,則為 NULL。 總線驅動程式會傳回單一位元組,指定目標的狀態。
TransferBufferMDL
描述駐留緩衝區的 MDL 指標,如果在 TransferBuffer 中提供緩衝區,則為 NULL。 總線驅動程式會傳回單一位元組,指定目標的狀態。 此 MDL 必須從非分頁集區配置。
UrbLink
保留的。 請勿使用。
hca
保留的。 請勿使用。
Reserved1[4]
保留的。 請勿使用。
Index
如果要求適用於端點或介面,則指定由成功組態要求傳回的裝置定義索引。 否則, Index 必須是零。
Reserved2
保留的。 請勿使用。
備註
驅動程式可以使用 UsbBuildGetStatusRequest 服務例程來格式化此 URB。
此結構的保留成員必須視為不透明,並保留供系統使用。
規格需求
需求 | 值 |
---|---|
標頭 | usb.h (包含 Usb.h) |