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 を含む) |