Функция PosCxPutPendingEvent (poscx.h)

Статья
02/07/2025

PosCxPutPendingEvent создает новый объект события, копирует данные события в новый объект события и пытается делегировать его вызывающему объекту ожидания. Если целевой вызывающий объект не ожидает запроса на чтение, новое событие добавляется в указанную очередь событий (управление или данные).

Синтаксис

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

Параметры

[in] device

Дескриптор объекта устройства платформы, представляющего устройство.

[in] deviceInterfaceTag

Интерфейс устройства, связанный с событием. По умолчанию только объекты файлов с тем же тегом получат это событие.

[in] eventType

Новый тип события.

[in] rawEventDataSize

Размер буфера необработанного события (без заголовка точки службы) в байтах.

rawEventDataPtr

Указатель на необработанные (без заголовка заголовка службы). Вызывающий объект может повторно использовать и выпускать rawEventDataPtr после возврата PosCxPutPendingEvent.

[in] eventAttr

Атрибуты события.

Возвращаемое значение

Возможные возвращаемые значения:

Ценность	Описание
STATUS_SUCCESS	Событие было создано и делегировано вызывающему объекту ожидания или событие было отменено, так как не существует владельца устройства.
STATUS_PENDING	Событие было в очереди, так как вызывающий объект в настоящее время не ожидает.
Другие ошибки	Другие соответствующие коды ошибок сбоя.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	poscx.h (include Poscx.h)

См. также

POS_CX_EVENT_ATTRIBUTES

Поделиться через