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。

此結構的保留成員必須視為不透明，並保留供系統使用。

規格需求

另請參閱

URB

USB 結構

_URB_HEADER