Méthode IMediaFilter::GetState (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 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