KsFilterCreatePinFactory function (ks.h)

The KsFilterCreatePinFactory function creates a new pin factory on the specified filter.

Syntax

KSDDKAPI NTSTATUS KsFilterCreatePinFactory(
  [in]  PKSFILTER                         Filter,
  [in]  const KSPIN_DESCRIPTOR_EX * const PinDescriptor,
  [out] PULONG                            PinID
);

Parameters

[in] Filter

A pointer to a KSFILTER structure for which to create a new pin factory.

[in] PinDescriptor

A pointer to a KSPIN_DESCRIPTOR_EX structure that describes the pins this factory will create.

[out] PinID

A pointer to the location containing the ID of the new factory.

Return value

KsFilterCreatePinFactory returns the success or failure of the attempt to create the pin factory. Failure may occur due to invalid parameters or low memory.

Remarks

Note that the filter control mutex must be held before calling this function. 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

KsFilterCreateNode