KsGateRemoveOnInputFromOr function (ks.h)

Article
02/22/2024

The KsGateRemoveOnInputFromOr function removes an existing input that is in the ON state from an OR gate.

Syntax

void KsGateRemoveOnInputFromOr(
  [in] PKSGATE OrGate
);

Parameters

[in] OrGate

A pointer to a KSGATE structure representing the OR gate from which to remove an ON input.

Return value

None

Remarks

Removing the last ON input from a given OR gate results in the gate closing and the transition being propagated to any gates connected to OrGate. For more information, see Flow Control Gates in AVStream.

KsGateRemoveOnInputFromOr should only be used on gates that were specifically created as AND gates; AVStream does not verify that the given gate is an AND gate.

This call is an inline function call to KsGateTurnInputOff. If conceptually removing an existing input to a gate, a minidriver should call KsGateRemoveOnInputFromOr rather than KsGateTurnInputOff.

Requirements

Requirement	Value
Minimum supported client	Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.
Target Platform	Desktop
Header	ks.h (include Ks.h)
IRQL	Any level