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

  • 아티클

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

GetWinUsbHandle 메서드는 USB 인터페이스와 연결된 WinUsb 인터페이스 핸들을 검색합니다.

구문

WINUSB_INTERFACE_HANDLE GetWinUsbHandle();

반환 값

GetWinUsbHandle 은 USB 인터페이스와 연결된 WinUsb 인터페이스 핸들을 반환합니다.

설명

기본 인터페이스에서 호출된 경우 IWDFUsbInterface::GetWinUsbHandle 메서드는 IWDFUsbTargetDevice::GetWinUsbHandle과 동일한 WinUsb 인터페이스 핸들을 반환합니다. 기본 인터페이스는 인덱스 0으로 식별됩니다.

인덱스가 0보다 큰 인터페이스에서 호출되는 경우 IWDFUsbInterface::GetWinUsbHandle 은 IWDFUsbTargetDevice::GetWinUsbHandle과 다른 핸들을 반환합니다.

UMDF 드라이버는 WinUsb 인터페이스 핸들을 사용하여 UMDF 인터페이스를 우회하고 인터페이스 관련 작업을 위해 WinUSB 루틴 을 직접 호출할 수 있습니다.

USB 인터페이스 개체가 핸들을 소유하기 때문에 UMDF 드라이버는 winUsb 인터페이스 핸들을 해제하기 위해 WinUsb_Free 함수를 호출해서는 안 됩니다.

요구 사항

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

추가 정보

IWDFUsbInterface

WinUsb_Free

WinUsb_Initialize