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

Статья
02/29/2024

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	Событие было поставлено в очередь, так как в настоящее время вызывающий объект не ожидает.
Другие ошибки	Другие соответствующие коды ошибок сбоя.

Требования

Требование	Значение
Целевая платформа	Windows
Header	poscx.h (включая Poscx.h)

См. также раздел

POS_CX_EVENT_ATTRIBUTES

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