KsFilterCreatePinFactory function

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

Syntax


NTSTATUS KsFilterCreatePinFactory(
  _In_        PKSFILTER           Filter,
  _In_  const KSPIN_DESCRIPTOR_EX *PinDescriptor,
  _Out_       PULONG              PinID
);

Parameters

Filter [in]

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

PinDescriptor [in]

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

PinID [out]

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

Target platform

Universal

Version

Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.

Header

Ks.h (include Ks.h)

Library

Ks.lib

IRQL

PASSIVE_LEVEL

See also

KsFilterCreateNode

 

 

Send comments about this topic to Microsoft

Show: