IRemoteInterfaceCallbackEvent::OnRemoteInterfaceEvent 메서드(wudfddi.h)

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

UMDF 기반 드라이버의 OnRemoteInterfaceEvent 이벤트 콜백 함수는 디바이스 인터페이스와 연결된 디바이스 이벤트를 처리합니다.

구문

void OnRemoteInterfaceEvent(
  [in]           IWDFRemoteInterface *pWdfRemoteInterface,
  [in]           REFGUID             EventGuid,
  [in, optional] BYTE                *pbData,
  [in]           DWORD               cbDataSize,
  [in]           DWORD               NameBufferOffset
);

매개 변수

[in] pWdfRemoteInterface

디바이스 인터페이스를 나타내는 원격 인터페이스 개체의 IWDFRemoteInterface 인터페이스에 대한 포인터입니다. 드라이버는 IWDFDevice2::CreateRemoteInterface를 호출할 때 이 포인터를 가져옵니다.

[in] EventGuid

이벤트 유형을 식별하는 GUID입니다. 이벤트 GUID는 이러한 GUID를 지원하는 구성 요소에 의해 정의됩니다. 일부 디바이스 인터페이스 클래스는 이벤트 GUID를 제공하고 일부 드라이버는 사용자 지정 이벤트를 제공합니다.

[in, optional] pbData

이벤트별 데이터를 포함하는 버퍼에 대한 포인터입니다. 일반적으로 이벤트 GUID를 정의하는 구성 요소는 이벤트 버퍼에 대한 이벤트별 구조도 정의합니다.

[in] cbDataSize

pbData가 가리키는 버퍼의 크기(바이트)입니다.

[in] NameBufferOffset

pbData가 가리키는 버퍼의 시작 부분부터 오프셋(바이트)입니다. 버퍼의 0에서 NameBufferOffset-1까지의 바이트는 이진 데이터를 포함합니다. NameBufferOffset에서 버퍼 끝까지의 바이트에는 유니코드 문자열 데이터가 포함됩니다.

반환 값

없음

설명

드라이버의 OnRemoteInterfaceEvent 이벤트 콜백 함수는 도착 및 제거 이벤트를 제외한 모든 디바이스 이벤트를 처리합니다. 이러한 이벤트는 IWDFDevice::P ostEvent에 대한 UMDF 기반 드라이버 호출 또는 IoReportTargetDeviceChange 또는 IoReportTargetDeviceChangeAsynchronous에 대한 커널 모드 드라이버 호출에서 비롯될 수 있습니다.

프레임워크는 드라이버가 IWDFRemoteTarget::OpenRemoteInterface를 호출한 후 OnRemoteInterfaceEvent 이벤트 콜백 함수를 호출하기 시작하고 디바이스 인터페이스의 원격 I/O 대상이 닫혀질 때까지 콜백 함수를 계속 호출합니다.

드라이버의 OnRemoteInterfaceEvent 이벤트 콜백 함수에 대한 자세한 내용은 UMDF 기반 드라이버에서 디바이스 인터페이스 사용을 참조하세요.

요구 사항

추가 정보

IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival

IRemoteInterfaceCallbackEvent

IRemoteInterfaceCallbackRemoval::OnRemoteInterfaceRemoval