次の方法で共有


KsGateCaptureThreshold 関数 (ks.h)

KsGateCaptureThreshold 関数は、Gate で指定された AND ゲートの ON 入力をキャプチャするために使用されます。

構文

BOOLEAN KsGateCaptureThreshold(
  [in] PKSGATE Gate
);

パラメーター

[in] Gate

ON 入力を同期的にキャプチャする AND ゲートを表す KSGATE 構造体へのポインター。

戻り値

AND ゲートが最初に開いていた場合、KsGateCaptureThresholdTRUE を返します。 TRUE を返すということは、他のスレッドが同時にゲートをキャプチャして処理を開始できないように、ゲートが閉じられたことを意味します。

注釈

KsGateCaptureThreshold は、指定された AND ゲートの状態を確認します。 ゲートが開いている場合、ゲートへの入力がオフになり、ゲートが閉じた状態に遷移します。 ゲートが閉じている場合、関数は何も行いません。 KsGateGetStateUnsafe とは異なり、この呼び出しは他のゲート状態の変更に関して同期的に行われます。 これは、ゲート制御に基づく処理の主要な同期メカニズムです。

その名前にもかかわらず、この関数は AND ゲートの有効な呼び出しに過ぎません。一般的にはゲートではありません。 ただし、AVStream では、 Gate が AND ゲートか OR ゲートかは検証されません。 呼び出しが AND ゲートでのみ行われるようにするのは、呼び出し元の責任です。

呼び出しはインターロック関数を使用して行われ、他のゲート状態変更関数に対して同期されます。また、プロセス制御の非常に効率的な方法です。

要件

要件
サポートされている最小のクライアント Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。
対象プラットフォーム デスクトップ
Header ks.h (Ks.h を含む)
IRQL 任意のレベル

こちらもご覧ください

KsGateAddOffInputToAnd

KsGateAddOffInputToOr

KsGateAddOnInputToAnd

KsGateAddOnInputToOr

KsGateGetStateUnsafe

KsGateInitializeAnd

KsGateInitializeOr

KsGateRemoveOffInputFromAnd

KsGateRemoveOffInputFromOr

KsGateRemoveOnInputFromAnd

KsGateRemoveOnInputFromOr

KsGateTurnInputOff

KsGateTurnInputOn