SourceFrameGetByNumber Method (IMFSource)
MFORMATSLib Namespace > IMFSource Interface : SourceFrameGetByNumber Method
frame's number
maximal wait time in milliseconds. By default use "-1".
converted frame object
additional parameters
Gets an original frame by its number. For live sources number is ignored.
Syntax
Sub SourceFrameGetByNumber( _
   ByVal _nFrameNo As Integer, _
   ByVal _rtMaxWait As Long, _
   ByRef _ppFrame As MFFrame, _
   ByVal _bsHints As String _
) 
void SourceFrameGetByNumber( 
   int _nFrameNo,
   long _rtMaxWait,
   out MFFrame _ppFrame,
   string _bsHints
)
procedure SourceFrameGetByNumber( 
    _nFrameNo: Integer;
    _rtMaxWait: Int64;
   Out  _ppFrame: MFFrame;
    _bsHints: String
); 
void SourceFrameGetByNumber( 
   int _nFrameNo,
   long _rtMaxWait,
   [PARAMFLAG::Out] MFFrame* _ppFrame,
   BSTR* _bsHints
)

Parameters

_nFrameNo
frame's number
_rtMaxWait
maximal wait time in milliseconds. By default use "-1".
_ppFrame
converted frame object
_bsHints
additional parameters
Example

Here is an example of how to get a frame from a file:

m_objPreview = new MFPreviewClass();
//Configure preview
m_objPreview.PreviewWindowSet("", panelPreview.Handle.ToInt32());
m_objPreview.PreviewEnable("", 1, 1);
m_objMFReader = new MFReaderClass();
m_objMFReader.ReaderOpen(sourceFileName, "");
MFFrame pFrame = null;
// Get next frame
if (m_objMFReader != null)
    m_objMFReader.SourceFrameGetByNumber(-1, -1, out pFrame, "");
m_objPreview.ReceiverFramePut(pFrame, -1, ""); // show the frame on preview
See Also

Reference

IMFSource Interface
IMFSource Members