KsGetMultiplePinFactoryItems function

Description

The KsGetMultiplePinFactoryItems function retrieves pin property items in a variable length data buffer.

Parameters

FilterHandle [in]

Handle to the filter that contains the pin factory to query.

PinFactoryId [in]

Identifier of the pin factory against which the property items are being returned.

PropertyId [in]

Identifier of the property in the pin property set (KSPROPSETID_Pin) to query.

Items [out]

Pointer to a buffer to receive the property items. If successfully retrieved, this pointer must be subsequently deleted with the CoTaskMemFree function.

Return value

Returns NOERROR if successful; otherwise, returns an error code.

Remarks

The KsGetMultiplePinFactoryItems function queries for the data size, in bytes, of the requested property, allocates a buffer, and retrieves the data.

For more information about CoTaskMemFree, see the Microsoft Windows SDK documentation.

See also

IKsPinFactory

KSPROPERTY

KSPROPSETID_Pin

KSP_PIN