Metodo IRemoteInterfaceCallbackEvent::OnRemoteInterfaceEvent (wudfddi.h)

  • Articolo

[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 OnRemoteInterfaceEvent di un driver basato su UMDF gestisce gli eventi del dispositivo associati a un'interfaccia del dispositivo.

Sintassi

void OnRemoteInterfaceEvent(
  [in]           IWDFRemoteInterface *pWdfRemoteInterface,
  [in]           REFGUID             EventGuid,
  [in, optional] BYTE                *pbData,
  [in]           DWORD               cbDataSize,
  [in]           DWORD               NameBufferOffset
);

Parametri

[in] pWdfRemoteInterface

Puntatore all'interfaccia IWDFRemoteInterface di un oggetto interfaccia remota che rappresenta un'interfaccia del dispositivo. Il driver ottiene questo puntatore quando chiama IWDFDevice2::CreateRemoteInterface.

[in] EventGuid

GUID che identifica il tipo di evento. I GUID evento sono definiti dai componenti che supportano tali GUID. Alcune classi di interfaccia del dispositivo forniscono GUID evento e alcuni driver forniscono eventi personalizzati.

[in, optional] pbData

Puntatore a un buffer che contiene dati specifici dell'evento. In genere, i componenti che definiscono GUID evento definiscono anche strutture specifiche dell'evento per i buffer eventi.

[in] cbDataSize

Dimensioni, in byte, del buffer a cui pbData punta.

[in] NameBufferOffset

Offset, in byte, dall'inizio del buffer a cui pbData punta. Byte da 0 a NameBufferOffset-1 del buffer contengono dati binari. Byte da NameBufferOffset alla fine del buffer contengono dati stringa Unicode.

Valore restituito

nessuno

Osservazioni

La funzione di callback dell'evento OnRemoteInterfaceEvent di un driver gestisce tutti gli eventi del dispositivo, ad eccezione degli eventi di arrivo e rimozione. Tali eventi possono derivare dalla chiamata di un driver basato su UMDF a IWDFDevice::P ostEvent o dalla chiamata di un driver in modalità kernel a IoReportTargetDeviceChange o IoReportTargetDeviceChangeAsynchronous.

Il framework inizia a chiamare la funzione di callback evento OnRemoteInterfaceEvent dopo che il driver chiama IWDFRemoteTarget::OpenRemoteInterface e continua a chiamare la funzione di callback fino alla chiusura della destinazione di I/O dell'interfaccia del dispositivo.

Per altre informazioni sulla funzione di callback dell'evento OnRemoteInterfaceEvent di un driver, 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)

Vedi anche

IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival

IRemoteInterfaceCallbackEvent

IRemoteInterfaceCallbackRemoval::OnRemoteInterfaceRemoval