Méthode IMFPMediaPlayer ::FrameStep (mfplay.h)

Important Déconseillée. Cette API peut être supprimée des versions ultérieures de Windows. Les applications doivent utiliser la session multimédia pour la lecture.
 

Avance d’une image vidéo.

Syntaxe

HRESULT FrameStep();

Valeur de retour

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
Étape de frame impossible. Les raisons de ce code d’erreur sont les suivantes :
  • Aucun élément multimédia n’est mis en file d’attente pour la lecture.
  • L’élément multimédia actuel ne contient pas de vidéo.
MF_E_SHUTDOWN
La méthode Shutdown de l’objet a été appelée.
MF_E_UNSUPPORTED_RATE
La source multimédia ne prend pas en charge le pas à pas d’images, ou le taux de lecture actuel est négatif.

Remarques

Cette méthode se termine de manière asynchrone. Une fois l’opération terminée, la méthode de rappel IMFPMediaPlayerCallback ::OnMediaPlayerEvent de l’application est appelée. Le type d’événement est MFP_EVENT_TYPE_FRAME_STEP.

L’objet player ne prend pas en charge le pas à pas d’image pendant la lecture inversée (autrement dit, alors que le taux de lecture est négatif).

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mfplay.h

Voir aussi

IMFPMediaPlayer

Utilisation de MFPlay pour la lecture audio/vidéo