Condividi tramite


Metodo IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival (wudfddi.h)

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedi Introduzione a UMDF.]

La funzione di callback di un driver OnRemoteInterfaceArrival informa il driver quando è disponibile un'interfaccia di dispositivo .

Sintassi

void OnRemoteInterfaceArrival(
  [in] IWDFRemoteInterfaceInitialize *pWdfRemoteInterfaceInit
);

Parametri

[in] pWdfRemoteInterfaceInit

Puntatore all'interfaccia IWDFRemoteInterfaceInitialize che identifica l'interfaccia del dispositivo che è arrivata.

Valore restituito

Nessuno

Osservazioni

Un driver basato su UMDF può registrare il proprio facoltativo OnRemoteInterfaceArrival funzione di callback degli eventi chiamando IWDFDevice2::RegisterRemoteInterfaceNotification.

Il driver può usare metodi dell'interfaccia IWDFRemoteInterfaceInitialize per determinare quale interfaccia del dispositivo è arrivata.

Prima che il driver possa inviare richieste di I/O all'interfaccia del dispositivo, il driver deve eseguire le operazioni seguenti:

  1. Chiamare IWDFDevice2::CreateRemoteInterface per creare un oggetto interfaccia remota.
  2. Chiamare IWDFDevice2::CreateRemoteTarget per creare un oggetto di destinazione remoto.
  3. Chiamare IWDFRemoteTarget::OpenRemoteInterface per connettere l'oggetto interfaccia all'oggetto di destinazione remoto e aprire la destinazione remota per le operazioni di I/O.
Per altre informazioni sull'uso di oggetti interfaccia remota per accedere alle interfacce dei dispositivi, vedere Using Device Interfaces in UMDF-based Drivers

Fabbisogno

Requisito Valore
Fine del supporto Non disponibile in UMDF 2.0 e versioni successive.
piattaforma di destinazione Desktop
versione minima di UMDF 1.9
intestazione wudfddi.h (include Wudfddi.h)

Vedere anche

IPnpCallbackRemoteInterfaceNotification

IWDFDevice2::CreateRemoteInterface

IWDFDevice2::CreateRemoteTarget

IWDFRemoteInterfaceInitialize

IWDFRemoteTarget::OpenRemoteInterface