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

[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.

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

Voir aussi

Codes d’erreur et de réussite

IBaseFilter

IMediaFilter, interface