IKsPin::KsQueryMediums method (ksproxy.h)

The KsQueryMediums method retrieves mediums that a pin supports.

Syntax

HRESULT KsQueryMediums(
  [out] PKSMULTIPLE_ITEM *MediumList
);

Parameters

[out] MediumList

Pointer to a buffer that receives a pointer to a KSMULTIPLE_ITEM structure, followed by a sequence of KSPIN_MEDIUM structures that describe medium types. The KSMULTIPLE_ITEM structure is a header that describes the size of the buffer and the number of entries in the list that follows the header.

Return value

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

Remarks

The returned mediums are ordered by preference.

Applications call KsQueryMediums to retrieve mediums that pins support in order to build a filter graph.

Requirements

See also

KSMULTIPLE_ITEM

KSPIN_MEDIUM