Metodo IRemoteInterfaceCallbackEvent::OnRemoteInterfaceEvent (wudfddi.h)

Articolo
02/07/2025

[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 basato su UMDF OnRemoteInterfaceEvent 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 dell'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 punta pbData.

[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 di un driver OnRemoteInterfaceEvent eventi gestisce tutti gli eventi del dispositivo tranne gli eventi di arrivo e rimozione. Tali eventi possono provenire 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 dell'evento OnRemoteInterfaceEvent dopo che il driver chiama IWDFRemoteTarget::OpenRemoteInterface e continua a chiamare la funzione di callback fino alla chiusura del di destinazione di I/O remoto dell'interfaccia del dispositivo.

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

IRemoteInterfaceCallbackEvent

IRemoteInterfaceCallbackRemoval::OnRemoteInterfaceRemoval

Condividi tramite