다음을 통해 공유


IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival 메서드(wudfddi.h)

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

드라이버의 OnRemoteInterfaceArrival 이벤트 콜백 함수는 디바이스 인터페이스 를 사용할 수 있을 때 드라이버에 알릴 수 있습니다.

구문

void OnRemoteInterfaceArrival(
  [in] IWDFRemoteInterfaceInitialize *pWdfRemoteInterfaceInit
);

매개 변수

[in] pWdfRemoteInterfaceInit

도착한 디바이스 인터페이스를 식별하는 IWDFRemoteInterfaceInitialize 인터페이스에 대한 포인터입니다.

반환 값

없음

설명

UMDF 기반 드라이버는 IWDFDevice2::RegisterRemoteInterfaceNotification을 호출하여 선택적 OnRemoteInterfaceArrival 이벤트 콜백 함수를 등록할 수 있습니다.

드라이버는 IWDFRemoteInterfaceInitialize 인터페이스의 메서드를 사용하여 도착한 디바이스 인터페이스를 확인할 수 있습니다.

드라이버가 디바이스 인터페이스에 I/O 요청을 보내려면 먼저 다음을 수행해야 합니다.

  1. IWDFDevice2::CreateRemoteInterface를 호출하여 원격 인터페이스 개체를 만듭니다.
  2. IWDFDevice2::CreateRemoteTarget을 호출하여 원격 대상 개체를 만듭니다.
  3. IWDFRemoteTarget::OpenRemoteInterface를 호출하여 인터페이스 개체를 원격 대상 개체에 연결하고 I/O 작업에 대한 원격 대상을 엽니다.
원격 인터페이스 개체를 사용하여 디바이스 인터페이스에 액세스하는 방법에 대한 자세한 내용은 UMDF 기반 드라이버에서 디바이스 인터페이스 사용을 참조하세요.

요구 사항

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

추가 정보

IPnpCallbackRemoteInterfaceNotification

IWDFDevice2::CreateRemoteInterface

IWDFDevice2::CreateRemoteTarget

IWDFRemoteInterfaceInitialize

IWDFRemoteTarget::OpenRemoteInterface