KsFilterGetFirstChildPin function (ks.h)

Article
02/22/2024

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