Share via

Méthode IMFSourceReader ::SetCurrentPosition (mfreadwrite.h)

  • Article

Cherche à un nouveau poste dans la source médiatique.

Syntaxe

HRESULT SetCurrentPosition(
  [in] REFGUID        guidTimeFormat,
  [in] REFPROPVARIANT varPosition
);

Paramètres

[in] guidTimeFormat

GUID qui spécifie le format d’heure. Le format d’heure définit les unités du paramètre varPosition . La valeur suivante est définie pour toutes les sources multimédias :

Valeur Signification
GUID_NULL
 Unités de 100 nanosecondes.
 

Certaines sources multimédias peuvent prendre en charge des valeurs supplémentaires.

[in] varPosition

Position à partir de laquelle la lecture sera démarrée. Les unités sont spécifiées par le paramètre guidTimeFormat . Si le paramètre guidTimeFormat est GUID_NULL, définissez le type de variante sur VT_I8.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
 S_OK
MF_E_INVALIDREQUEST
 Un ou plusieurs exemples de demandes sont toujours en attente.

Remarques

La méthode SetCurrentPosition ne garantit pas la recherche exacte. La précision de la recherche dépend du contenu multimédia. Si le contenu multimédia contient un flux vidéo, la méthode SetCurrentPosition recherche généralement l’image clé la plus proche avant la position souhaitée. La distance entre les images clés dépend de plusieurs facteurs, notamment l’implémentation de l’encodeur, le contenu vidéo et les paramètres d’encodage particuliers utilisés pour encoder le contenu. La distance entre l’image clé peut varier au sein d’un seul fichier vidéo (par exemple, en fonction de la complexité de la scène).

Après avoir recherché, l’application doit appeler IMFSourceReader ::ReadSample et passer à la position souhaitée.

Cette interface est disponible sur Windows Vista si le Supplément mise à jour de la plateforme pour Windows Vista est installé.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Supplément windows 7, Windows Vista et mise à jour de la plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête mfreadwrite.h

Voir aussi

IMFSourceReader

Lecteur source