IAMStreamConfig::GetStreamCaps

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method obtains audio, video, or other capabilities of a stream depending on which type of structure is pointed to in the pSCC parameter.

Syntax

HRESULT GetStreamCaps(
  int iIndex,
  AM_MEDIA_TYPE** pmt,
  BYTE* pSCC
);

Parameters

• iIndex
  [in] Index to the desired media type and capability pair. Use the IAMStreamConfig::GetNumberOfCapabilities method to retrieve the total number of these pairs. Possible index values range from zero to one less than the total number of pairs.

• pmt
  [out] Address of a pointer to an AM_MEDIA_TYPE structure.

• pSCC
  [out] Pointer to a stream configuration structure.

Return Value

Returns an HRESULT value that depends on the implementation of the interface.

Remarks

This method enables you to get more information about accepted media types rather than the traditional way of enumerating a pin's media types, so you typically should use it instead of pin enumeration. Information such as media types, and sizes is returned by the VIDEO_STREAM_CONFIG_CAPS structure. Audio capabilities of the filter's output pin, including the number of inputs, sampling rate, and bit rate granularity, will be returned by an AUDIO_STREAM_CONFIG_CAPS structure.

Call DeleteMediaType to free the pmt media type.

Requirements

See Also

Reference

IAMStreamConfig::GetNumberOfCapabilities
DeleteMediaType
AM_MEDIA_TYPE
VIDEO_STREAM_CONFIG_CAPS
AUDIO_STREAM_CONFIG_CAPS