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 diesen Wert zurück, und die Uhrzeit wird von dort aus erhöht. Wenn der Wert PRESENTATION_CURRENT_POSITION ist, beginnt die Uhr aus der aktuellen Position. Verwenden Sie diesen Wert, wenn die Uhr angehalten wird, und Sie möchten sie an derselben Position neu starten.
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. |
|
Auf dieser Uhr wurde keine Zeitquelle festgelegt. |
Hinweise
Diese Methode ist in allen Zuständen gültig (beendet, angehalten oder ausgeführt).
Wenn die Uhr angehalten und aus 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 durch Aufrufen von OnClockStart oder OnClockRestart auf der Zeitquelle der Uhr. Dieser Aufruf wird synchron ausgeführt. Wenn es fehlschlägt, tritt die Statusänderung nicht auf. 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 Anrufe werden asynchron ausgeführt.
Wenn die Uhr bereits ausgeführt wird, hat das Aufrufen von Start erneut den Effekt, die Uhr auf die neue StartOffset-Position zu suchen.
Anforderungen
| 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 |