_URB_CONTROL_TRANSFER_EX構造体 (usb.h)

[アーティクル]
03/05/2024

_URB_CONTROL_TRANSFER_EX構造は、USB クライアントドライバーがコントロールパイプとの間でデータを転送するために使用され、許容される転送時間を制限するタイムアウトが発生します。

構文

struct _URB_CONTROL_TRANSFER_EX {
  struct _URB_HEADER   Hdr;
  USBD_PIPE_HANDLE     PipeHandle;
  ULONG                TransferFlags;
  ULONG                TransferBufferLength;
  PVOID                TransferBuffer;
  PMDL                 TransferBufferMDL;
  ULONG                Timeout;
  ULONG                Pad;
  struct _URB_HCD_AREA hca;
  UCHAR                SetupPacket[8];
};

メンバー

Hdr

URB ヘッダー情報を指定する _URB_HEADER 構造体へのポインター。 Hdr.Function はURB_FUNCTION_CONTROL_TRANSFER_EXする必要があり、 Hdr.Length はである sizeof(_URB_CONTROL_TRANSFER_EX)必要があります。

PipeHandle

パイプのハンドル。

target が既定のコントロールエンドポイントの場合、 PipeHandle は NULL である必要があります。この場合、 TransferFlags には USBD_DEFAULT_PIPE_TRANSFER フラグが含まれている必要があります。

target が既定以外のコントロールエンドポイントの場合、 PipeHandle はコントロールパイプの不透明なハンドルを指定します。ホストコントローラードライバーは、クライアントドライバーが URB の種類が URB_FUNCTION_SELECT_CONFIGURATIONのデバイス構成を選択したとき、またはクライアントドライバーが URB_FUNCTION_SELECT_INTERFACE 型の URB を持つインターフェイスの設定を変更すると、このハンドルを返します。

TransferFlags

0、1、または次のフラグの組み合わせを指定します。

値	意味
USBD_TRANSFER_DIRECTION_IN	デバイスからデータを要求するように設定されます。デバイスにデータを転送するには、このフラグをクリアする必要があります。
USBD_TRANSFER_DIRECTION_OUT	デバイスにデータを転送するように設定されます。このフラグを設定することは、USBD_TRANSFER_DIRECTION_IN フラグをクリアすることと同じです。
USBD_SHORT_TRANSFER_OK	エンドポイントの最大パケットサイズより短いパケットをデバイスから受信したときに、ホストコントローラーがエラーを返さないように設定します。エンドポイントの最大パケットサイズは、既定の制御エンドポイントのUSB_DEVICE_DESCRIPTOR構造体 (デバイス記述子) の bMaxPacketSize0 メンバーで報告されます。既定以外の制御エンドポイントの場合、最大パケットサイズは、USB_ENDPOINT_DESCRIPTOR構造体 (エンドポイント記述子) の wMaxPacketSize メンバーで設定されます。ホストコントローラーが、コントロールエンドポイントの wMaxPacketSize 値よりも短いパケットを受信すると、ホストコントローラーの種類に応じて動作は次のようになります。 EHCI ホストコントローラーでは、ホストコントローラーは制御転送の状態フェーズにすぐに進みます。 USBD_SHORT_TRANSFER_OKが設定されているかどうかに関係なく、転送は正常に完了します。 UHCI および OHCI ホストコントローラーでは、USBD_SHORT_TRANSFER_OKが設定されている場合、ホストコントローラーは状態フェーズに進みます。 USBD_SHORT_TRANSFER_OKが設定されていない場合、ホストコントローラーはコントロール転送のデータフェーズとステータスフェーズを破棄し、転送がエラーで完了します。
USBD_DEFAULT_PIPE_TRANSFER	既定のコントロールパイプで制御転送を実行するようにホストコントローラーに指示するように設定されます。これにより、呼び出し元は、パイプハンドルを明示的に指定せずに、既定のコントロールパイプにコマンドを送信できます。

TransferBufferLength

TransferBuffer で指定されたバッファーまたは TransferBufferMDL で説明されているバッファーの長さをバイト単位で指定します。ホストコントローラードライバーは、このメンバー内のパイプに送信または読み取られたバイト数を返します。

TransferBuffer

転送の常駐バッファーへのポインター。MDL が TransferBufferMDL で指定されている場合は NULL です。このバッファーの内容は、 TransferFlags の値によって異なります。 USBD_TRANSFER_DIRECTION_INが指定されている場合、このバッファーには、ホストコントローラードライバーから返されるときにデバイスから読み取られたデータが含まれます。それ以外の場合、このバッファーには、デバイスに転送するためのドライバー指定のデータが含まれます。

TransferBufferMDL

常駐バッファーを記述する MDL へのポインター。バッファーが TransferBuffer で指定されている場合は NULL です。バッファーの内容は、 TransferFlags の値によって異なります。 USBD_TRANSFER_DIRECTION_INが指定されている場合、記述されたバッファーには、ホストコントローラードライバーから返されるときにデバイスから読み取られたデータが含まれます。それ以外の場合、バッファーには、デバイスに転送するためのドライバー指定のデータが含まれます。この MDL は、非ページプールから割り当てる必要があります。

Timeout

URB がタイムアウトするまでの時間をミリ秒単位で示します。値 0 は、この URB にタイムアウトがないことを示します。

Pad

予約済み。使用しないでください。

hca

予約済み。使用しないでください。

SetupPacket[8]

USB 定義の要求セットアップパケットを指定します。 USB 要求セットアップパケットの形式は、USB コア仕様に記載されています。

注釈

この URB 構造体は、_URB_CONTROL_TRANSFERと同じですが、 タイムアウト メンバーによって URB のタイムアウトが確立される点が除きます。

この構造体の予約済みメンバーは不透明として扱う必要があり、システム使用のために予約されています。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のオペレーティングシステムで使用できます。
Header	usb.h (Usb.h を含む)

こちらもご覧ください

Urb

USB 構造体

_URB_CONTROL_TRANSFER

_URB_HEADER

次の方法で共有

_URB_CONTROL_TRANSFER_EX構造体 (usb.h)

構文

メンバー

注釈

要件

こちらもご覧ください

フィードバック

その他のリソース