MÉTHODE IMFSeekInfo::GetNearestKeyFrames (mfidl.h)

  • Article

Pour une position de recherche particulière, obtient les deux images clés les plus proches.

Syntaxe

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

Paramètres

[in] pguidTimeFormat

Pointeur vers un GUID qui spécifie le format d’heure. Le format d’heure définit les unités pour les autres paramètres de cette méthode. Si la valeur est GUID_NULL, le format d’heure est d’unités de 100 nanosecondes. Certaines sources multimédias peuvent prendre en charge des GUID de format de temps supplémentaires.

[in] pvarStartPosition

Position de recherche. Les unités de ce paramètre sont spécifiées par pguidTimeFormat.

[out] pvarPreviousKeyFrame

Reçoit la position de l’image clé la plus proche qui apparaît avant pvarStartPosition. Les unités de ce paramètre sont spécifiées par pguidTimeFormat.

[out] pvarNextKeyFrame

Reçoit la position de l’image clé la plus proche qui apparaît après pvarStartPosition. Les unités de ce paramètre sont spécifiées par pguidTimeFormat.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
 S_OK
MF_E_UNSUPPORTED_TIME_FORMAT
 Le format d’heure spécifié dans pguidTimeFormat n’est pas pris en charge.

Notes

Si une application recherche une image non clé, le décodeur doit commencer le décodage à partir de la trame clé précédente. Cela peut augmenter la latence, car plusieurs images peuvent être décodées avant que la trame demandée soit atteinte. Pour réduire la latence, une application peut appeler cette méthode pour rechercher les deux images clés les plus proches de l’heure souhaitée, puis rechercher l’une de ces images clés.

Configuration requise

   
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mfidl.h

Voir aussi

IMFSeekInfo