KsGateCaptureThreshold function

The KsGateCaptureThreshold function is used to capture an ON input of an AND gate specified by Gate.

Syntax


BOOLEAN __inline KsGateCaptureThreshold(
  _In_ PKSGATE Gate
);

Parameters

Gate [in]

A pointer to a KSGATE structure representing the AND gate for which to capture an ON input synchronously.

Return value

KsGateCaptureThreshold returns TRUE if the AND gate was originally open. Note that returning TRUE implies that the gate was closed so that no other thread could simultaneously capture the gate and commence processing.

Remarks

KsGateCaptureThreshold checks the state of the given AND gate. If the gate is open, it turns off an input to the gate, thereby transitioning the gate to a closed state. If the gate is closed, the function does nothing. Unlike KsGateGetStateUnsafe, this call is done synchronously with respect to other gate state changes. It is the primary synchronization mechanism for processing based on gate control.

Despite its name, this function is only a valid call for AND gates, not gates in general. AVStream, however, does not verify whether Gate is an AND gate or an OR gate. It is the caller's responsibility to ensure that the call is only made on AND gates.

The call is made using interlocked functions and is thus synchronous with respect to any of the other gate state change functions; it is also a very efficient method of process control.

Requirements

Target platform

Desktop

Version

Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.

Header

Ks.h (include Ks.h)

IRQL

Any level

See also

KsGateInitializeAnd
KsGateInitializeOr
KsGateGetStateUnsafe
KsGateAddOnInputToAnd
KsGateAddOnInputToOr
KsGateAddOffInputToAnd
KsGateAddOffInputToOr
KsGateRemoveOnInputFromAnd
KsGateRemoveOnInputFromOr
KsGateRemoveOffInputFromAnd
KsGateRemoveOffInputFromOr
KsGateTurnInputOn
KsGateTurnInputOff

 

 

Send comments about this topic to Microsoft

Show: