Metodo IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival (wudfddi.h)

Articolo
02/27/2024

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta 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, vedere Introduzione con UMDF.]

La funzione di callback dell'evento OnRemoteInterfaceArrival di un driver informa il driver quando è disponibile un'interfaccia del 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 la funzione di callback dell'evento OnRemoteInterfaceArrival 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:

Chiamare IWDFDevice2::CreateRemoteInterface per creare un oggetto interfaccia remota.
Chiamare IWDFDevice2::CreateRemoteTarget per creare un oggetto di destinazione remoto.
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 del dispositivo, vedere Uso di interfacce dispositivo nei driver basati su UMDF

Requisiti

Requisito	Valore
Fine del supporto	Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione	Desktop
Versione UMDF minima	1,9
Intestazione	wudfddi.h (include Wudfddi.h)