IMFClockStateSink::OnClockStart-Methode (mfidl.h)
Wird aufgerufen, wenn die Präsentationsuhr beginnt.
Syntax
HRESULT OnClockStart(
[in] MFTIME hnsSystemTime,
[in] LONGLONG llClockStartOffset
);
Parameter
[in] hnsSystemTime
Die Systemzeit, zu der die Uhr gestartet wurde, in 100 Nanosekundeneinheiten.
[in] llClockStartOffset
Die neue Startzeit für die Uhr in 100 Nanosekundeneinheiten. Dieser Parameter kann auch PRESENTATION_CURRENT_POSITION entsprechen, was angibt, dass die Uhr von ihrer aktuellen Position aus gestartet oder neu gestartet wurde.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Diese Methode wird aufgerufen, wenn die IMFPresentationClock::Start-Methode der Präsentationsuhr aufgerufen wird, mit der folgenden Ausnahme: Wenn die Uhr angehalten und Start mit dem Wert PRESENTATION_CURRENT_POSITION aufgerufen wird, wird IMFClockStateSink::OnClockRestart anstelle von OnClockStart aufgerufen.
Die Uhr benachrichtigt die Präsentationszeitquelle, indem die OnClockStart-Methode der Zeitquelle aufgerufen wird. Dieser Aufruf erfolgt synchron innerhalb der Start-Methode . Wenn die Zeitquelle einen Fehler von OnClockStart zurückgibt, gibt die Start-Methode der Präsentationsuhr einen Fehler zurück, und die Zustandsänderung findet nicht statt.
Für jedes Objekt, das nicht die Präsentationszeitquelle ist, wird die OnClockStart-Methode asynchron aufgerufen, nachdem die Zustandsänderung abgeschlossen ist. In diesem Fall wird der Rückgabewert dieser Methode ignoriert.
Der in llClockStartOffset angegebene Wert ist die Präsentationszeit, zu der die Uhr beginnt, also relativ zum Beginn der Präsentation. Mediensenken sollten keine Daten mit einer Präsentationszeit vor llClockStartOffSet rendern. Wenn ein Beispiel den Offset überschreitet, d. h. wenn der Offset zwischen den Start- und Stoppzeiten des Beispiels liegt, sollte die Senke das Beispiel entweder so kürzen, dass nur Daten nach llClockStartOffset gerendert werden, oder das Beispiel einfach löschen.
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 |