IMediaPosition::get_PrerollTime

 
Microsoft DirectShow 9.0

IMediaPosition::get_PrerollTime

The get_PrerollTime method retrieves the amount of data that will be queued before the start position.

Syntax

  HRESULT get_PrerollTime(
  REFTIME *pllTime
);

Parameters

pllTime

[out] Pointer to a variable that receives the preroll time, in seconds.

Return Values

Returns an HRESULT value. Possible values include the following.

Return code Description
S_OK Success.
E_NOTIMPL Not implemented.
E_POINTER NULL pointer argument.

Remarks

The preroll is the time prior to the start position at which nonrandom access devices, such as tape players, should start rolling.

If no filter in the graph implements this method, the Filter Graph Manager sets the value of *pllTime to zero and returns S_OK.

Requirements

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

Library: Use Strmiids.lib.

See Also