IAMGraphStreams::SetMaxGraphLatency

  • Article
 
Microsoft DirectShow 9.0

IAMGraphStreams::SetMaxGraphLatency

The SetMaxGraphLatency method sets the maximum latency for the graph. You must call the IAMGraphStreams::SyncUsingStreamOffset method before calling this method.

Syntax

  HRESULT SetMaxGraphLatency(
  REFERENCE_TIME rtMaxGraphLatency
);

Parameters

rtMaxGraphLatency

[in] Specifies the maximum latency in 100-nanosecond units.

Return Values

Returns an HRESULT value. Possible values include the following.

Value Description
E_FAIL Failure
S_OK Success

Remarks

At connection time, some live source filters use the maximum latency to determine the size of buffer to allocate. Calling this method before constructing the graph can help to ensure that sufficient buffers are allocated for the expected latency.

If you call this method beforing calling SyncUsingStreamOffset, the method returns E_FAIL.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also