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 기반 드라이버 디바이스 인터페이스 사용참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 바탕 화면 |
| 최소 UMDF 버전 | 1.9 |
| 헤더 | wudfddi.h(Wudfddi.h 포함) |
참고 항목
IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival