IAMPushSource::GetMaxStreamOffset method (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The GetMaxStreamOffset
method retrieves the maximum stream offset the filter can support.
Syntax
HRESULT GetMaxStreamOffset(
[out] REFERENCE_TIME *prtMaxOffset
);
Parameters
[out] prtMaxOffset
Pointer to a variable that receives a reference time indicating the maximum offset the filter can support.
Return value
Returns an HRESULT value that depends on the implementation of the interface. The DirectShow implementation returns E_POINTER or S_OK.
Remarks
If the stream offset is set to a value larger than the maximum supported offset, the filter is not guaranteed to have a buffer large enough to hold data for the entire amount of the offset. Unless there is another buffer downstream, data might be lost.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Target Platform | Windows |
Header | strmif.h (include Dshow.h) |
Library | Strmiids.lib |