Expand Minimize

KsPinAttachOrGate function

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_opt_  PKSGATE OrGate
);

Parameters

Pin [in]

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

OrGate [in, optional]

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

Target platform

Universal

Version

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

Header

Ks.h (include Ks.h)

Library

Ks.lib

IRQL

PASSIVE_LEVEL (See Remarks section)

See also

KsPinAttachAndGate
KsGateInitializeOr
KSGATE

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft