KsFilterGetChildPinCount function

The KsFilterGetChildPinCountfunctionreturns the number of pins of a given type that are currently instantiated on a given filter.

Syntax

KSDDKAPI ULONG KsFilterGetChildPinCount(
  PKSFILTER Filter,
  ULONG     PinId
);

Parameters

Filter

A pointer to the KSFILTER structure for which to find the number of instantiated pins of type PinID.

PinId

The pin type for which to find the number of instantiated pins. PinID is an index into the array of pin descriptors for the filter to which the pin belongs.

Return Value

KsFilterGetChildPinCount returns the number of pins of type PinID that are currently instantiated on Filter. If no such pins exist or if PinID is out of range, zero is returned.

Remarks

The count returned by this call is guaranteed to be correct only if the function is called while the filter control mutex is held. The count remains correct after the call as long as this mutex continues to be held. As soon as the mutex is released, other pins can be added or removed, thereby altering the actual pin count.

For more information, see Mutexes in AVStream.

Requirements

   
Windows version 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

KSFILTER

KSPIN

KsFilterGetFirstChildPin

KsPinGetNextSiblingPin