IAMVideoControl::GetFrameRateList

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method retrieves a list of available frame rates.

Syntax

HRESULT GetFrameRateList (
  IPin*      pPin,
  long       iIndex,
  SIZE       Dimensions,
  long*      ListSize,
  LONGLONG** FrameRates
);

Parameters

• pPin
  [in] Pointer to the IPin Interface to query for the list of frame rates.

• iIndex
  [in] A long value that is the index of the format to query for frame rates. This index corresponds to the order in which formats are enumerated by IAMStreamConfig::GetStreamCaps. The value must range between zero and the number of supported VIDEO_STREAM_CONFIG_CAPS structures returned by IAMStreamConfig::GetNumberOfCapabilities) minus one.

• Dimensions
  [in] A SIZE structure that specifies the frame image size (width and height) in pixels.

• ListSize
  [out] A pointer to a long value that is the number of elements in the list of frame rates.

• FrameRates
  [out] Address of a pointer to an array of LONGLONG values that are frame rates in 100-nanosecond units. Can be NULL if you only need ListSize.

Return Value

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

Remarks

The caller is responsible for freeing the memory through a call to CoTaskMemFree.

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

Requirements

See Also

Reference

IAMVideoControl Interface
VIDEO_STREAM_CONFIG_CAPS
IPin Interface
IAMStreamConfig::GetStreamCaps
VIDEO_STREAM_CONFIG_CAPS
IAMStreamConfig::GetNumberOfCapabilities

Other Resources

SIZE
CoTaskMemFree