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 구조체는 WdfUsbTargetPipeGetInformation, WdfUsbInterfaceGetConfiguredPipe 및 WdfUsbInterfaceGetEndpointInformation 메서드로 채워집니다.

WDF_USB_PIPE_INFORMATION 구조를 초기화하려면 드라이버가 WDF_USB_PIPE_INFORMATION_INIT 호출해야 합니다.

이 구조체의 MaximumPacketSize 멤버에 대한 자세한 내용은 USBD_PIPE_INFORMATION 설명 섹션을 참조하세요.

USB 디바이스에서 지원되는 등시 엔드포인트와 데이터를 전송하는 방법에 대한 자세한 내용은 USB 등시 엔드포인트로 데이터를 전송하는 방법을 참조하세요.

요구 사항

요구 사항	값
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
머리글	wdfusb.h(Wdfusb.h 포함)

추가 정보

USBD_PIPE_INFORMATION

WDF_USB_PIPE_INFORMATION_INIT

WDF_USB_PIPE_TYPE

WdfUsbInterfaceGetConfiguredPipe

WdfUsbInterfaceGetEndpointInformation

WdfUsbTargetPipeGetInformation