IMFPresentationClock::Start-Methode (mfidl.h)

Startet die Präsentationsuhr.

Syntax

HRESULT Start(
  [in] LONGLONG llClockStartOffset
);

Parameter

[in] llClockStartOffset

Anfangsstartzeit in 100 Nanosekundeneinheiten. Zum Zeitpunkt des Aufrufs der Start-Methode gibt die IMFPresentationClock::GetTime-Methode der Uhr diesen Wert zurück, und die Uhrzeit wird von dort inkrementiert. Wenn der Wert PRESENTATION_CURRENT_POSITION ist, beginnt die Uhr an ihrer aktuellen Position. Verwenden Sie diesen Wert, wenn die Uhr angehalten ist und Sie sie von derselben Position aus neu starten möchten.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
Die Methode wurde erfolgreich ausgeführt.
MF_E_CLOCK_NO_TIME_SOURCE
Für diese Uhr wurde keine Zeitquelle festgelegt.

Hinweise

Diese Methode ist in allen Zuständen (beendet, angehalten oder wird ausgeführt) gültig.

Wenn die Uhr angehalten und von derselben Position neu gestartet wird (llClockStartOffset ist PRESENTATION_CURRENT_POSITION), sendet die Präsentationsuhr eine IMFClockStateSink::OnClockRestart-Benachrichtigung . Andernfalls sendet die Uhr eine IMFClockStateSink::OnClockStart-Benachrichtigung .

Die Präsentationsuhr initiiert die Zustandsänderung, indem OnClockStart oder OnClockRestart für die Zeitquelle der Uhr aufgerufen wird. Dieser Aufruf erfolgt synchron. Wenn ein Fehler auftritt, erfolgt die Zustandsänderung nicht. Wenn der Aufruf erfolgreich ist, ändert sich der Zustand, und die Uhr benachrichtigt die anderen Zustandsänderungsabonnenten, indem sie ihre OnClockStart - oder OnClockRestart-Methoden aufrufen. Diese Aufrufe werden asynchron ausgeführt.

Wenn die Uhr bereits ausgeführt wird, führt das erneute Aufrufen von Start zur Suche nach der Uhr zur neuen StartOffset-Position .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfuuid.lib

Weitere Informationen

IMFPresentationClock

Präsentationsuhr