KsGateRemoveOffInputFromAnd function (ks.h)

Article
02/22/2024

The KsGateRemoveOffInputFromAnd function removes an existing input that is in the OFF state from an AND gate.

Syntax

void KsGateRemoveOffInputFromAnd(
  [in] PKSGATE AndGate
);

Parameters

[in] AndGate

A pointer to a KSGATE structure representing the AND gate from which to remove an OFF input.

Return value

None

Remarks

Removing the last OFF input from the gate results in the gate opening and the transition being propagated to any gates connected to AndGate. For more information, see Flow Control Gates in AVStream.

KsGateRemoveOffInputFromAnd 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.

KsGateRemoveOffInputFromAnd is an inline function call to KsGateTurnInputOn. If conceptually removing an existing input to the gate rather than turning it off, a minidriver should call KsGateRemoveOffInputFromAnd instead of KsGateTurnInputOn.

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