WDF_USB_PIPE_INFORMATION 構造体 (wdfusb.h)

[KMDF と UMDF に適用]

WDF_USB_PIPE_INFORMATION構造体には、USB パイプとそのエンドポイントに関する情報が含まれています。

構文

typedef struct _WDF_USB_PIPE_INFORMATION {
  ULONG             Size;
  ULONG             MaximumPacketSize;
  UCHAR             EndpointAddress;
  UCHAR             Interval;
  UCHAR             SettingIndex;
  WDF_USB_PIPE_TYPE PipeType;
  ULONG             MaximumTransferSize;
} WDF_USB_PIPE_INFORMATION, *PWDF_USB_PIPE_INFORMATION;

メンバー

Size

この構造体のサイズ (バイト単位)。

MaximumPacketSize

パイプのエンドポイントが送受信できる最大パケット サイズ (バイト単位)。

高速等時性エンドポイントの場合、受信した MaximumPacketSize 値には、エンドポイントでサポートされている場合に追加のトランザクションで転送できるバイト数が含まれます。

EndpointAddress

USB デバイス上のエンドポイントのアドレス。 エンドポイント アドレスの詳細については、USB の仕様に関するページを参照してください。

Interval

PipeType メンバーが WdfUsbPipeTypeInterrupt に設定されている場合のエンドポイントのポーリング間隔。 ポーリング間隔の詳細については、USB 仕様に関するページを参照してください。

SettingIndex

パイプが属するインターフェイス内の代替設定を識別するインデックス値。 代替設定の詳細については、USB 仕様に関するページを参照してください。

PipeType

パイプの種類を指定する WDF_USB_PIPE_TYPE型指定された値。

MaximumTransferSize

このメンバーは使用されません。

注釈

WDF_USB_PIPE_INFORMATION構造体は、WdfUsbTargetPipeGetInformationWdfUsbInterfaceGetConfiguredPipe、および WdfUsbInterfaceGetEndpointInformation メソッドによって入力されます。

WDF_USB_PIPE_INFORMATION構造体を初期化するには、ドライバーが WDF_USB_PIPE_INFORMATION_INIT を呼び出す必要があります。

この構造体の MaximumPacketSize メンバーの詳細については、USBD_PIPE_INFORMATIONの「解説」セクション 参照してください。

USB デバイスでサポートされている等時性エンドポイントとの間でデータを転送する方法については、「USB 等時性エンドポイント にデータを転送する方法」を参照してください。

要件

要件
最小 KMDF バージョン 1.0
最小 UMDF バージョン 2.0
Header wdfusb.h (Wdfusb.h を含む)

こちらもご覧ください

USBD_PIPE_INFORMATION

WDF_USB_PIPE_INFORMATION_INIT

WDF_USB_PIPE_TYPE

WdfUsbInterfaceGetConfiguredPipe

WdfUsbInterfaceGetEndpointInformation

WdfUsbTargetPipeGetInformation