KsPinAttachOrGate function (ks.h)

Article
02/22/2024

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

Syntax

void KsPinAttachOrGate(
  [in]           PKSPIN  Pin,
  [in, optional] PKSGATE OrGate
);

Parameters

[in] Pin

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

[in, optional] OrGate

A pointer to a KSGATE structure that is the previously initialized OR 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 KsGateInitializeOr. Then call KsPinAttachOrGate. For more information, see Flow Control Gates in AVStream.

Do not leave an unattached OR gate at filter creation time. Instead, create the OR gate later, for example when the minidriver instantiates the pin.

KsPinAttachOrGate 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)