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