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

  • Article

[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