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