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 |
|---|---|
|
Erfolg. |
|
Ungültiges Argument. |
|
Die Methode wird nicht unterstützt. |
|
NULL-Zeigerargument. |
|
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 |