PosCxPutPendingEvent-Funktion (poscx.h)

Artikel
02/26/2024

PosCxPutPendingEvent erstellt ein neues Ereignisobjekt, kopiert die Ereignisdaten in das neue Ereignisobjekt und versucht, es an den wartenden Aufrufer zu delegieren. Wenn der Zielaufrufer keine Leseanforderung wartet, wird das neue Ereignis der angegebenen 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 für ein Framework-Geräteobjekt, das das Gerät darstellt.

[in] deviceInterfaceTag

Die dem Ereignis zugeordnete Geräteschnittstelle. Standardmäßig erhalten nur Dateiobjekte, die dasselbe Tag aufweisen, dieses Ereignis.

[in] eventType

Der neue Ereignistyp.

[in] rawEventDataSize

Die Rohereignispuffergröße (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 wurde.

[in] eventAttr

Die Ereignisattribute.

Rückgabewert

Mögliche Rückgabewerte sind:

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

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	poscx.h (einschließlich Poscx.h)

Weitere Informationen

POS_CX_EVENT_ATTRIBUTES

Freigeben über