KsFilterGetFirstChildPin function (ks.h)

The KsFilterGetFirstChildPin function returns the first instantiated pin of type PinID on the filter specified by Filter.

Syntax

KSDDKAPI PKSPIN KsFilterGetFirstChildPin(
  [in] PKSFILTER Filter,
  [in] ULONG     PinId
);

Parameters

[in] Filter

A pointer to the KSFILTER structure to query for instantiated pins.

[in] PinId

The numeric ID of the pin type for which to find the first instantiated member.

Return value

KsFilterGetFirstChildPin returns a pointer to the first instantiated KSPIN structure of type PinID on the specified filter.

Remarks

Note that the object hierarchy is guaranteed stable only while the appropriate mutex is held, in this case the filter control mutex. For more information, see Mutexes in AVStream.

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 also

KSPIN

KsFilterGetChildPinCount

KsPinGetNextSiblingPin