IAMStreamConfig::GetStreamCaps
A version of this page is also available for
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
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later |
See Also
Reference
IAMStreamConfig::GetNumberOfCapabilities
DeleteMediaType
AM_MEDIA_TYPE
VIDEO_STREAM_CONFIG_CAPS
AUDIO_STREAM_CONFIG_CAPS