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
事件屬性。
傳回值
可能的傳回值為:
值 | Description |
---|---|
STATUS_SUCCESS | 事件已建立並委派給等候呼叫者,或因為沒有裝置擁有者而捨棄事件。 |
STATUS_PENDING | 事件已排入佇列,因為目前沒有呼叫端正在等候。 |
其他錯誤 | 其他適當的失敗錯誤碼。 |
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | poscx.h (包含 Poscx.h) |