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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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 |