Méthode IMediaFilter::GetState (strmif.h)

Article
07/28/2023

[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 méthode GetState récupère l’état du filtre (en cours d’exécution, arrêté ou suspendu).

Syntaxe

HRESULT GetState(
  [in]  DWORD        dwMilliSecsTimeout,
  [out] FILTER_STATE *State
);

Paramètres

[in] dwMilliSecsTimeout

Intervalle de délai d’attente, en millisecondes. Pour bloquer indéfiniment, utilisez la valeur INFINITE.

[out] State

Reçoit un membre de l’FILTER_STATE type énuméré, indiquant l’état du filtre.

Valeur renvoyée

Retourne une valeur HRESULT . Les valeurs possibles incluent celles indiquées dans le tableau suivant.

Code de retour	Description
S_OK	Opération réussie.
E_POINTER	Argument pointeur NULL .
VFW_S_STATE_INTERMEDIATE	État intermédiaire.
VFW_S_CANT_CUE	Le filtre est actif, mais ne peut pas fournir de données.

Notes

Les transitions d’état peuvent être asynchrones. Si le filtre est en cours de transition vers un nouvel état et que la méthode expire avant la fin de la transition, la méthode retourne VFW_S_STATE_INTERMEDIATE.

Si un filtre ne peut pas fournir de données pour une raison quelconque, il retourne VFW_S_CANT_CUE. Les filtres de capture dynamique retournent cette valeur en pause, car ils ne fournissent pas de données dans l’état suspendu.

Pour plus d’informations, consultez Data Flow dans le graphe de filtres.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [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

IBaseFilter

IMediaFilter, interface

Partager via