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 到緩衝區結尾的位元組包含 Unicode 字串數據。
傳回值
沒有
言論
驅動程式的 OnRemoteInterfaceEvent 事件回呼函式會處理抵達和移除事件以外的所有裝置事件。 這類事件可能源自於以 UMDF 為基礎的驅動程式呼叫 IWDFDevice：:P ostEvent，或來自核心模式驅動程式呼叫 IoReportTargetDeviceChange 或 IoReportTargetDeviceChangeAsynchronous。
此架構會在驅動程式呼叫 IWDFRemoteTarget：：OpenRemoteInterface 後，開始呼叫 OnRemoteInterfaceEvent 事件回呼函式，直到裝置介面的 遠端 I/O 目標 關閉為止。
如需驅動程式 OnRemoteInterfaceEvent 事件回呼函式的詳細資訊，請參閱 在 UMDF 型驅動程式中使用裝置介面。
要求
| 要求 | 價值 |
|---|---|
| 終止支援 | UMDF 2.0 和更新版本中無法使用。 |
| 目標平臺 | 桌面 |
| 最低 UMDF 版本 | 1.9 |
| 標頭 | wudfddi.h （包括 Wudfddi.h） |
另請參閱
IPnpCallbackRemoteInterfaceNotification：：OnRemoteInterfaceArrival