IMFSeekInfo::GetNearestKeyFrames-Methode (mfidl.h)

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