IRemoteInterfaceCallbackEvent::OnRemoteInterfaceEvent-Methode (wudfddi.h)

Artikel
08/08/2023

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die OnRemoteInterfaceEvent-Ereignisrückruffunktion eines UMDF-basierten Treibers verarbeitet Geräteereignisse, die einer Geräteschnittstelle zugeordnet sind.

Syntax

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

Parameter

[in] pWdfRemoteInterface

Ein Zeiger auf die IWDFRemoteInterface-Schnittstelle eines Remoteschnittstellenobjekts, das eine Geräteschnittstelle darstellt. Der Treiber ruft diesen Zeiger ab, wenn er IWDFDevice2::CreateRemoteInterface aufruft.

[in] EventGuid

Eine GUID, die den Ereignistyp identifiziert. Ereignis-GUIDs werden von den Komponenten definiert, die solche GUIDs unterstützen. Einige Geräteschnittstellenklassen stellen Ereignis-GUIDs bereit, und einige Treiber stellen benutzerdefinierte Ereignisse bereit.

[in, optional] pbData

Ein Zeiger auf einen Puffer, der ereignisspezifische Daten enthält. In der Regel definieren Komponenten, die Ereignis-GUIDs definieren, auch ereignisspezifische Strukturen für Ereignispuffer.

[in] cbDataSize

Die Größe des Puffers, auf den pbData verweist, in Bytes.

[in] NameBufferOffset

Ein Offset in Bytes vom Anfang des Puffers, auf den pbData verweist. Bytes von 0 bis NameBufferOffset-1 des Puffers enthalten Binärdaten. Bytes von NameBufferOffset bis zum Ende des Puffers enthalten Unicode-Zeichenfolgendaten.

Rückgabewert

Keine

Bemerkungen

Die OnRemoteInterfaceEvent-Ereignisrückruffunktion eines Treibers verarbeitet alle Geräteereignisse mit Ausnahme von Ankunfts- und Entfernungsereignissen. Solche Ereignisse können vom Aufruf eines UMDF-basierten Treibers an IWDFDevice::P ostEvent oder vom Aufruf eines Kernelmodustreibers an IoReportTargetDeviceChangeChange oder IoReportTargetDeviceChangeAsynchrone stammen.

Das Framework beginnt mit dem Aufrufen der OnRemoteInterfaceEvent-Ereignisrückruffunktion , nachdem der Treiber IWDFRemoteTarget::OpenRemoteInterface aufgerufen hat, und setzt den Aufruf der Rückruffunktion fort, bis das Remote-E/A-Ziel der Geräteschnittstelle geschlossen ist.

Weitere Informationen zur OnRemoteInterfaceEvent-Ereignisrückruffunktion eines Treibers finden Sie unter Verwenden von Geräteschnittstellen in UMDF-basierten Treibern.

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.9
Kopfzeile	wudfddi.h (include Wudfddi.h)

Weitere Informationen

IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival

IRemoteInterfaceCallbackEvent

IRemoteInterfaceCallbackRemoval::OnRemoteInterfaceRemoval

Freigeben über