IMediaSeeking::SetTimeFormat-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die SetTimeFormat -Methode legt das Zeitformat für nachfolgende Suchvorgänge fest.

Syntax

HRESULT SetTimeFormat(
  [in] const GUID *pFormat
);

Parameter

[in] pFormat

Zeiger auf eine GUID, die das Zeitformat angibt. Weitere Informationen finden Sie unter Zeitformat-GUIDs.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_INVALIDARG	Ungültiges Argument.
E_NOTIMPL	Die Methode wird nicht unterstützt.
E_POINTER	NULL-Zeigerargument.
VFW_E_WRONG_STATE	Filterdiagramm wird nicht beendet.

Hinweise

Diese Methode gibt die Zeiteinheiten an, die von anderen IMediaSeeking-Methoden wie IMediaSeeking::GetPositions und IMediaSeeking::SetPositions verwendet werden. Wenn Sie eine dieser anderen Methoden aufrufen, werden alle Parameter, die Zeitwerte ausdrücken, in Einheiten des aktuellen Zeitformats angegeben.

Das Standardzeitformat ist REFERENCE_TIME Einheiten (100 Nanosekunden). Andere Zeitformate umfassen Frames, Beispiele und Bytes. Um festzustellen, ob ein bestimmtes Format unterstützt wird, rufen Sie die IMediaSeeking::IsFormatSupported-Methode auf . Wenn ein Format unterstützt wird, können Sie zu diesem Format wechseln, indem Sie aufrufen SetTimeFormat. Nur ein Zeitformat ist gleichzeitig aktiv.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IMediaSeeking-Schnittstelle

IMediaSeeking::GetTimeFormat

IMediaSeeking::QueryPreferredFormat