IWDFUsbTargetDevice::RetrieveUsbInterface 메서드(wudfusb.h)
[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]
RetrieveUsbInterface 메서드는 USB 디바이스에 대해 지정된 USB 인터페이스를 검색합니다.
구문
HRESULT RetrieveUsbInterface(
[in] UCHAR InterfaceIndex,
[out] IWDFUsbInterface **ppUsbInterface
);
매개 변수
[in] InterfaceIndex
검색할 인터페이스의 인덱스입니다.
[out] ppUsbInterface
USB 디바이스에 대해 지정된 IWDFUsbInterface 인터페이스에 대한 포인터를 수신하는 변수에 대한 포인터입니다.
반환 값
RetrieveUsbInterface 는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
RetrieveUsbInterface 가 USB 디바이스에 대해 지정된 USB 인터페이스를 성공적으로 검색했습니다. |
|
RetrieveUsbInterface 에서 할당 오류가 발생했습니다. |
|
이 값은 WinUsb API가 반환한 오류 코드에 해당합니다. |
설명
드라이버는 IWDFUsbTargetDevice::GetNumInterfaces 메서드를 호출하여 사용 가능한 총 USB 인터페이스 수를 검색할 수 있습니다.
드라이버는 RetrieveUsbInterface 가 검색하는 인터페이스 포인터를 사용하여 IWDFUsbInterface 인터페이스가 제공하는 메서드를 호출할 수 있습니다. 이러한 메서드를 사용하는 방법에 대한 자세한 내용은 UMDF에서 USB 인터페이스 작업을 참조하세요.
예제
RetrieveUsbInterface 메서드를 사용하는 방법에 대한 코드 예제는 IWDFUsbTargetFactory::CreateUsbTargetDevice를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 데스크톱 |
| 최소 UMDF 버전 | 1.5 |
| 머리글 | wudfusb.h(Wudfusb.h 포함) |
| DLL | WUDFx.dll |