共用方式為


IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival 方法 (wudfddi.h)

[警告: UMDF 2 是最新版的 UMDF,並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1,且較新版本的 #DBB4EB86222D64301A8A27EF1A44025D4 上,UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊,請參閱使用 UMDF 使用者入門。]

驅動程式的 OnRemoteInterfaceArrival 事件回呼函式會在 裝置介面 可用時通知驅動程式。

語法

void OnRemoteInterfaceArrival(
  [in] IWDFRemoteInterfaceInitialize *pWdfRemoteInterfaceInit
);

參數

[in] pWdfRemoteInterfaceInit

IWDFRemoteInterfaceInitialize 介面的指標,可識別已抵達的裝置介面。

傳回值

備註

UMDF 型驅動程式可以藉由呼叫 IWDFDevice2::RegisterRemoteInterfaceNotification 來註冊其選擇性 OnRemoteInterfaceArrival 事件回呼函式。

驅動程式可以使用 IWDFRemoteInterfaceInitialize 介面的方法來判斷哪些裝置介面已抵達。

驅動程式必須先執行下列動作,驅動程式才能將I/O要求傳送至裝置介面:

  1. 呼叫 IWDFDevice2::CreateRemoteInterface 以建立遠端介面物件。
  2. 呼叫 IWDFDevice2::CreateRemoteTarget 以建立遠端目標物件。
  3. 呼叫 IWDFRemoteTarget::OpenRemoteInterface ,將介面對象連接到遠端目標物件,並開啟 I/O 作業的遠端目標。
如需使用遠端介面物件存取裝置介面的詳細資訊,請參閱 在 UMDF 型驅動程式中使用裝置介面

規格需求

需求
終止支援 在 UMDF 2.0 和更新版本中無法使用。
目標平台 桌面
最低UMDF版本 1.9
標頭 wudfddi.h (包含 Wudfddi.h)

另請參閱

IPnpCallbackRemoteInterfaceNotification

IWDFDevice2::CreateRemoteInterface

IWDFDevice2::CreateRemoteTarget

IWDFRemoteInterfaceInitialize

IWDFRemoteTarget::OpenRemoteInterface