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 | 呼び出し元が現在待機していないため、イベントはキューに登録されました。 |
その他のエラー | その他の適切なエラー コード。 |
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | ウィンドウズ |
ヘッダー | poscx.h (Poscx.h を含む) |