KsPinAttachOrGate function (ks.h)
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) |