IRemoteInterfaceCallbackEvent：：OnRemoteInterfaceEvent 方法 (wudfddi.h)
[警告： UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1，且較新版本的 #D7D3912CF0CD74697A0C575C9F24C710C 上，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 到緩衝區結尾的位元組包含 Unicode 字串數據。
傳回值
無
備註
驅動程式的 OnRemoteInterfaceEvent 事件回呼函式會處理抵達和移除事件以外的所有裝置事件。 這類事件可能源自 UMDF 型驅動程式對 IWDFDevice：:P ostEvent 的呼叫，或來自核心模式驅動程式對 IoReportTargetDeviceChange 或 IoReportTargetDeviceChangeAsynchronous 的呼叫。
架構會在驅動程式呼叫 IWDFRemoteTarget：：OpenRemoteInterface 之後開始呼叫 OnRemoteInterface 事件回呼函式，並繼續呼叫回呼函式，直到裝置介面的遠端 I/O 目標關閉為止。
如需驅動程式 OnRemoteInterfaceEvent 事件回呼函式的詳細資訊，請參閱 在 UMDF 型驅動程式中使用裝置介面。
規格需求
| 需求 | 值 |
|---|---|
| 終止支援 | 在 UMDF 2.0 和更新版本中無法使用。 |
| 目標平台 | 桌面 |
| 最低UMDF版本 | 1.9 |
| 標頭 | wudfddi.h (包含 Wudfddi.h) |
另請參閱
IPnpCallbackRemoteInterfaceNotification：：OnRemoteInterfaceArrival