IMFSeekInfo::GetNearestKeyFrames-Methode (mfidl.h)

Artikel
08/24/2023

Ruft für eine bestimmte Suchposition die beiden nächstgelegenen Keyframes ab.

Syntax

HRESULT GetNearestKeyFrames(
  [in]  const GUID        *pguidTimeFormat,
  [in]  const PROPVARIANT *pvarStartPosition,
  [out] PROPVARIANT       *pvarPreviousKeyFrame,
  [out] PROPVARIANT       *pvarNextKeyFrame
);

Parameter

[in] pguidTimeFormat

Ein Zeiger auf eine GUID, die das Zeitformat angibt. Das Zeitformat definiert die Einheiten für die anderen Parameter dieser Methode. Wenn der Wert GUID_NULL ist, ist das Zeitformat 100 Nanosekundeneinheiten. Einige Medienquellen unterstützen möglicherweise zusätzliche Zeitformat-GUIDs.

[in] pvarStartPosition

Die Suchposition. Die Einheiten für diesen Parameter werden durch pguidTimeFormat angegeben.

[out] pvarPreviousKeyFrame

Empfängt die Position des nächstgelegenen Keyframes, die vor pvarStartPosition angezeigt wird. Die Einheiten für diesen Parameter werden durch pguidTimeFormat angegeben.

[out] pvarNextKeyFrame

Empfängt die Position des nächstgelegenen Keyframes, die später als pvarStartPosition angezeigt wird. Die Einheiten für diesen Parameter werden durch pguidTimeFormat angegeben.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
MF_E_UNSUPPORTED_TIME_FORMAT	Das in pguidTimeFormat angegebene Zeitformat wird nicht unterstützt.

Hinweise

Wenn eine Anwendung einen Nicht-Schlüsselrahmen anstrebt, muss der Decoder mit der Decodierung über den vorherigen Keyframe beginnen. Dies kann die Latenz erhöhen, da möglicherweise mehrere Frames decodiert werden, bevor der angeforderte Frame erreicht wird. Um die Latenz zu verringern, kann eine Anwendung diese Methode aufrufen, um die beiden Keyframes zu finden, die der gewünschten Zeit am nächsten sind, und dann einen dieser Keyframes suchen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mfidl.h

Weitere Informationen

IMFSeekInfo

Freigeben über