KsPinAttachAndGate function (ks.h)

Article
02/22/2024

The KsPinAttachAndGate function connects Pin as an input to a previously initialized AND gate, and connects AndGate as an input to the relevant filter's AND gate.

Syntax

void KsPinAttachAndGate(
  [in]           PKSPIN  Pin,
  [in, optional] PKSGATE AndGate
);

Parameters

[in] Pin

A pointer to the KSPIN structure to use an input to the AND gate.

[in, optional] AndGate

A pointer to a KSGATE structure that is the previously initialized AND gate to connect to the relevant filter's AND gate. If this optional parameter is NULL, any KSGATE currently attached to the pin is detached.

Return value

None

Remarks

To insert the gate, first call KsGateInitializeAnd. Then call KsPinAttachAndGate. For more information, see Flow Control Gates in AVStream.

KsPinAttachAndGate must be called at IRQL = PASSIVE_LEVEL before the pin in question leaves KSSTATE_STOP.

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	Universal
Header	ks.h (include Ks.h)
Library	Ks.lib
IRQL	PASSIVE_LEVEL (See Remarks section)