IVideoFrameStep ::Step, méthode (strmif.h)

Article
03/02/2024

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La Step méthode fait avancer le graphe de filtre en fonction du nombre d’images spécifié.

Syntaxe

HRESULT Step(
  DWORD    dwFrames,
  IUnknown *pStepObject
);

Paramètres

dwFrames

Spécifie le nombre d’images à ignorer. Si dwFrames a la valeur 1, le graphique avance d’une image. Si dwFrames est un nombre n supérieur à 1, le graphique ignore n - 1 images et affiche le nièmeframe.

pStepObject

Pointeur vers une interface sur le filtre qui contrôlera l’opération pas à pas, ou NULL. Spécifiez NULL pour effectuer le pas à pas d’image à l’aide du filtre de renderer dans le graphique. S’il n’est pas NULL, l’objet doit implémenter l’interface IKsPropertySet et prendre en charge la propriété AM_KSPROPSETID_FrameStep. (Pour plus d’informations, consultez Frame Stepping Property Set.) Si le graphique inclut un filtre personnalisé qui implémente l’exécution pas à pas d’images, pStepObject peut spécifier un pointeur vers ce filtre.

Valeur retournée

Retourne un HRESULT. Les valeurs possibles sont les suivantes.

Code de retour	Description
S_OK	Réussite.
VFW_E_FRAME_STEP_UNSUPPORTED	Le pas à pas de frame n’est pas pris en charge.
E_INVALIDARG	Le paramètre pStepObject n’est pas valide.

Remarques

Une fois l’opération d’étape terminée, cette méthode envoie une notification d’événement EC_STEP_COMPLETE au gestionnaire de graphe de filtres, qui la transmet à la boucle d’événements de l’application et définit le graphe de filtre à un état suspendu.

Étape d’images en temps réel, ce qui signifie que si le film est lus à 30 images par seconde, l’appel de IVideoFrameStep ::Step avec dwFrames défini sur 60 prend 2 secondes pour s’exécuter. Toutes les méthodes de cette interface étant asynchrones, le contrôle revient immédiatement à l’application.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IVideoFrameStep, interface

Partager via