PosCxPutPendingEvent 函数 (poscx.h)

  • 项目

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

指向不带服务点标头的原始 (的指针) 事件数据。 在 PosCxPutPendingEvent 返回后，调用方可以重复使用/释放 rawEventDataPtr。

[in] eventAttr

事件属性。

返回值

可能的返回值为：

值 说明
STATUS_SUCCESS 已创建事件并将其委托给等待调用方，或者由于没有设备所有者而放弃该事件。
STATUS_PENDING 事件已排队，因为当前没有调用方正在等待。
其他错误 其他适当的失败错误代码。

要求

要求 值
目标平台 Windows
标头 poscx.h (包括 Poscx.h)

另请参阅

POS_CX_EVENT_ATTRIBUTES