KsGateCaptureThreshold 関数 (ks.h)
KsGateCaptureThreshold 関数は、Gateで指定された AND ゲートの ON 入力をキャプチャするために使用されます。
構文
BOOLEAN KsGateCaptureThreshold(
[in] PKSGATE Gate
);
パラメーター
[in] Gate
ON 入力を同期的にキャプチャする AND ゲートを表す KSGATE 構造体へのポインター。
戻り値
KsGateCaptureThreshold 、AND ゲートが最初に開いていた場合 TRUE を返します。 TRUE 返すことは、他のスレッドが同時にゲートをキャプチャして処理を開始できないように、ゲートが閉じられたことを意味します。
備考
KsGateCaptureThreshold 指定された AND ゲートの状態を確認します。 ゲートが開いている場合は、ゲートへの入力をオフにして、ゲートを閉じた状態に遷移させます。 ゲートが閉じている場合、関数は何もしません。 KsGateGetStateUnsafeとは異なり、この呼び出しは、他のゲート状態の変更に関して同期的に実行されます。 ゲート制御に基づく処理の主要な同期メカニズムです。
その名前にもかかわらず、この関数は AND ゲートの有効な呼び出しに過ぎません。一般的にはゲートではありません。 ただし、AVStream では、ゲート が AND ゲートか OR ゲートかを確認しません。 呼び出しが AND ゲートでのみ行われるようにするのは呼び出し元の責任です。
呼び出しは、インターロックされた関数を使用して行われるので、他のゲート状態変更関数に対して同期されます。また、プロセス制御の非常に効率的な方法です。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | ks.h (Ks.h を含む) |
| IRQL | 任意のレベル |
関連項目
KsGateAddOnInputToAnd を する
KsGateGetStateUnsafe の
KsGateInitializeAnd を する