Edit

Share via

PosCxPutPendingEventMemory function (poscx.h)

  • Article

PosCxPutPendingEventMemory tries to delegate a memory object containing the event data to a waiting caller. If the target caller does not have a read request waiting, the new event is added to the designated event queue (control or data).

Syntax

NTSTATUS PosCxPutPendingEventMemory(
  [in] WDFDEVICE               device,
  [in] ULONG                   deviceInterfaceTag,
  [in] WDFMEMORY               eventMemory,
  [in] POS_CX_EVENT_ATTRIBUTES eventAttr
);

Parameters

[in] device

A handle to a framework device object that represents the device.

[in] deviceInterfaceTag

The device interface associated with the event. By default, only file objects that have the same tag will receive this event.

[in] eventMemory

The new event data memory object that contains both the point-of-service event header and the data. PosCx will take over ownership of this passed in memory object.

[in] eventAttr

The event attributes.

Return value

Possible return values are:

Value Description
STATUS_SUCCESS The event was created and delegated to a waiting caller, or the event was discarded because there is no device owner.
STATUS_PENDING The event was queued because no caller is currently waiting.
STATUS_DEVICE_NOT_READY The PosCx library was not successfully initialized.
Other errors Other appropriate failure error codes.

Requirements

Requirement Value
Target Platform Windows
Header poscx.h (include Poscx.h)

See also

POS_CX_EVENT_ATTRIBUTES