KsGateCaptureThreshold 関数 (ks.h)

[アーティクル]
02/26/2024

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	任意のレベル