다음을 통해 공유


IWDFUsbInterface::RetrieveUsbPipeObject 메서드(wudfusb.h)

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]

RetrieveUsbPipeObject 메서드는 지정된 파이프 인덱스에 대한 USB 파이프 개체를 검색합니다.

구문

HRESULT RetrieveUsbPipeObject(
  [in]  UCHAR             PipeIndex,
  [out] IWDFUsbTargetPipe **ppPipe
);

매개 변수

[in] PipeIndex

검색할 USB 파이프 개체의 인덱스입니다.

[out] ppPipe

PipeIndex에서 인덱스를 지정한 USB 파이프 개체의 IWDFUsbTargetPipe 인터페이스에 대한 포인터를 수신하는 변수에 대한 포인터입니다.

반환 값

RetrieveUsbPipeObject 는 다음 값 중 하나를 반환합니다.

반환 코드 설명
S_ok

RetrieveUsbPipeObject 가 USB 파이프 개체를 성공적으로 검색했습니다.

E_OUTOFMEMORY

RetrieveUsbPipeObject 에서 할당 오류가 발생했습니다.

Winerror.h에 정의된 오류 코드
이 값은 WinUsb API가 반환한 오류 코드에 해당합니다.

설명

UMDF 드라이버는 RetrieveUsbPipeObject 메서드가 검색하는 IWDFUsbTargetPipe 인터페이스의 메서드를 호출하여 파이프 형식 및 기타 정보를 가져올 수 있습니다.

예제

RetrieveUsbPipeObject 메서드를 사용하는 방법에 대한 코드 예제는 IWDFUsbInterface::GetNumEndPoints를 참조하세요.

요구 사항

요구 사항
지원 종료 UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼 데스크톱
최소 UMDF 버전 1.5
머리글 wudfusb.h(Wudfusb.h 포함)
DLL WUDFx.dll

추가 정보

IWDFUsbInterface

IWDFUsbTargetPipe