PosCxPutPendingEvent-Funktion (poscx.h)

Artikel
02/07/2025

PosCxPutPendingEvent erstellt ein neues Ereignisobjekt, kopiert die Ereignisdaten in das neue Ereignisobjekt und versucht, es an den Warteaufrufer zu delegieren. Wenn der Zielanrufer keine Leseanforderung wartet, wird das neue Ereignis der vorgesehenen Ereigniswarteschlange (Steuerelement oder Daten) hinzugefügt.

Syntax

NTSTATUS PosCxPutPendingEvent(
  [in] WDFDEVICE               device,
  [in] ULONG                   deviceInterfaceTag,
  [in] ULONG                   eventType,
  [in] size_t                  rawEventDataSize,
       PVOID                   rawEventDataPtr,
  [in] POS_CX_EVENT_ATTRIBUTES eventAttr
);

Parameter

[in] device

Ein Handle zu einem Framework-Geräteobjekt, das das Gerät darstellt.

[in] deviceInterfaceTag

Die dem Ereignis zugeordnete Geräteschnittstelle. Standardmäßig erhalten nur Dateiobjekte mit demselben Tag dieses Ereignis.

[in] eventType

Der neue Ereignistyp.

[in] rawEventDataSize

Die Puffergröße des unformatierten Ereignisses (ohne Point-of-Service-Header) in Bytes.

rawEventDataPtr

Der Zeiger auf die unformatierten Ereignisdaten (ohne Point-of-Service-Header). Der Aufrufer kann rawEventDataPtr wiederverwenden/freigeben, nachdem PosCxPutPendingEvent zurückgegeben wird.

[in] eventAttr

Die Ereignisattribute.

Rückgabewert

Mögliche Rückgabewerte sind:

Wert	Beschreibung
STATUS_SUCCESS	Das Ereignis wurde erstellt und an einen Warteanrufer delegiert, oder das Ereignis wurde verworfen, da kein Gerätebesitzer vorhanden ist.
STATUS_PENDING	Das Ereignis wurde in die Warteschlange gestellt, da zurzeit kein Anrufer wartet.
Andere Fehler	Andere geeignete Fehlercodes.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	poscx.h (include Poscx.h)

Siehe auch

POS_CX_EVENT_ATTRIBUTES

Freigeben über