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

IRemoteInterfaceCallbackEvent

IRemoteInterfaceCallbackRemoval：：OnRemoteInterfaceRemoval