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 인터페이스에서 제공하는 메서드를 호출할 수 있습니다. 이러한 메서드를 사용하는 방법에 대한 자세한 내용은 UMDFUSB 인터페이스로 작업하는 방법을 참조하세요.
예제
RetrieveUsbInterface 메서드를 사용하는 방법에 대한 코드 예제는 IWDFUsbTargetFactory::CreateUsbTargetDevice참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 바탕 화면 |
| 최소 UMDF 버전 | 1.5 |
| 헤더 | wudfusb.h(Wudfusb.h 포함) |
| DLL | WUDFx.dll |