IWDFDevice::P ostEvent-Methode (wudfddi.h)

Artikel
02/27/2024

[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 für neuere 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 PostEvent-Methode benachrichtigt Anwendungen asynchron, die auf das angegebene Ereignis von einem Treiber warten.

Syntax

HRESULT PostEvent(
  [in] REFGUID        EventGuid,
  [in] WDF_EVENT_TYPE EventType,
  [in] BYTE           *pbData,
  [in] DWORD          cbDataSize
);

Parameter

[in] EventGuid

Die GUID für das Ereignis. Die GUID wird von der Anwendung und dem Treiber bestimmt und ist für das Framework undurchsichtig.

[in] EventType

Ein WDF_EVENT_TYPE typisierter Wert, der den Ereignistyp identifiziert. In der aktuellen Version von UMDF muss der Treiber EventType auf WdfEventBroadcast (1) festlegen. WdfEventBroadcast gibt an, dass das Ereignis übertragen wird. Anwendungen können Ereignisse vom Typ WdfEventBroadcast abonnieren. Zum Empfangen von Broadcastereignissen muss sich die Anwendung für Benachrichtigungen über die Microsoft Win32 RegisterDeviceNotification-Funktion registrieren. Ereignisse vom Typ WdfEventBroadcast werden anwendungen als ereignisse vom typ DBT_CUSTOMEVENT verfügbar gemacht.

[in] pbData

Ein Zeiger auf einen Puffer, der Daten enthält, die dem Ereignis zugeordnet sind. NULL ist ein gültiger Wert.

[in] cbDataSize

Die Größe der Daten, auf die pbData verweist, in Bytes. Null ist ein gültiger Größenwert, wenn pbData auf NULL festgelegt ist.

Die maximale Größe der Ereignisdaten ist etwas kleiner als MAXUSHORT (64 KB). Die genaue Obergrenze ist (0xFFFF – FIELD_OFFSET(TARGET_DEVICE_CUSTOM_NOTIFICATION, CustomDataBuffer)).

Rückgabewert

PostEvent gibt einen der folgenden Werte zurück:

Rückgabecode	BESCHREIBUNG
S_OK	Die Ereignisdaten wurden erfolgreich an das Betriebssystem gesendet.
HRESULT_FROM_WIN32(ERROR_NOT_ENOUGH_MEMORY)	Die vom cbDataSize-Parameter festgelegte Datengröße ist größer als die maximal zulässige Größe.
E_INVALIDARG	Der EventType-Parameter ist nicht auf WdfEventBroadcast (1) festgelegt.
E_OUTOFMEMORY	PostEvent konnte keinen Speicher zuordnen, der für den Abschluss erforderlich war.

PostEvent kann auch andere HRESULT-Werte zurückgeben.

Hinweise

Wenn der Treiber IWDFDevice::P ostEvent aufruft , um die anfordernde Anwendung über ein Ereignis zu benachrichtigen, sendet UMDF das Ereignis an das Betriebssystem. Das Betriebssystem sendet das Ereignis in einem asynchronen Vorgang an die anfordernde Anwendung weiter. Wenn das Betriebssystem zunächst keinen Fehler zurückgibt, erhält der Treiber keinen Fehler (S_OK). Wenn das Betriebssystem jedoch später einen Fehler empfängt, während es versucht, das Ereignis zu übermitteln (möglicherweise aufgrund einer geringen Arbeitsspeicherbedingung), kann das Betriebssystem den Treiber nicht über den Fehler informieren. Aufgrund der asynchronen Natur dieser Ereignisbenachrichtigung ist die Übermittlung des Ereignisses an die anfordernde Anwendung nicht garantiert. Wenn Ereignisinformationen auf dem Weg zur anfordernden Anwendung verloren gehen, sollte die Anwendung in der Lage sein, das verlorene Ereignis wiederherzustellen.

Informationen zum Erstellen von Geräteereignissen finden Sie unter Verwenden von Geräteschnittstellen in UMDF-Treibern.

Anforderungen

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

Weitere Informationen

FIELD_OFFSET

IWDFDevice

TARGET_DEVICE_CUSTOM_NOTIFICATION

WdfDevicePostEvent

Share via