PosCxPutPendingEvent function (poscx.h)

  • Article

PosCxPutPendingEvent creates a new event object, copies the event data to the new event object, and tries to delegate it to the 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 PosCxPutPendingEvent(
  [in] WDFDEVICE               device,
  [in] ULONG                   deviceInterfaceTag,
  [in] ULONG                   eventType,
  [in] size_t                  rawEventDataSize,
       PVOID                   rawEventDataPtr,
  [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] eventType

The new event type.

[in] rawEventDataSize

The raw event (without point-of-service header) buffer size in bytes.

rawEventDataPtr

The pointer to the raw (without point-of-service header) event data. The caller may reuse/release rawEventDataPtr after PosCxPutPendingEvent returns.

[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.
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