IMediaSeeking::SetTimeFormat

  • Article
 
Microsoft DirectShow 9.0

IMediaSeeking::SetTimeFormat

The SetTimeFormat method sets the time format for subsequent seek operations.

Syntax

  HRESULT SetTimeFormat(
  const GUID *pFormat
);

Parameters

pFormat

[in] Pointer to a GUID that specifies the time format. See Time Format GUIDs.

Return Values

Returns an HRESULT value. Possible values include the following.

Return code Description
S_OK Success.
E_INVALIDARG Invalid argument.
E_NOTIMPL Method is not supported.
E_POINTER NULL pointer argument.
VFW_E_WRONG_STATE Filter graph is not stopped.

Remarks

This method specifies the time units used by other IMediaSeeking methods, such as IMediaSeeking::GetPositions and IMediaSeeking::SetPositions. Whenever you call one of these other methods, any parameters that express time values are given in units of the current time format.

The default time format is REFERENCE_TIME units (100 nanoseconds). Other time formats include frames, samples, and bytes. To determine if a given format is supported, call the IMediaSeeking::IsFormatSupported method. If a format is supported, you can switch to that format by calling SetTimeFormat. Only one time format is active at any one time.

Requirements

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

Library: Use Strmiids.lib.

See Also