Méthode CBaseRenderer.GetState

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

Syntaxe

HRESULT GetState(
   DWORD        dwMilliSecsTimeout,
   FILTER_STATE *State
);

Paramètres

dwMilliSecsTimeout

Intervalle de délai d’attente, en millisecondes.

State

Pointeur vers une variable qui reçoit un membre du type énuméré FILTER_STATE , indiquant l’état du filtre.

Valeur renvoyée

Retourne l’une des valeurs HRESULT indiquées dans le tableau suivant.

Code de retour Description
S_OK
 Opération réussie.
VFW_S_STATE_INTERMEDIATE
 Le filtre passe à l’état indiqué.
E_POINTER
 Argument pointeur NULL .

Notes

Cette méthode remplace la méthode CBaseFilter::GetState . Lorsque le renderer est suspendu, il ne termine pas la transition d’état tant qu’il n’a pas reçu un exemple à afficher. Si le délai d’attente expire avant la fin de la transition d’état, la méthode retourne VFW_S_STATE_INTERMEDIATE.

Configuration requise

Condition requise Valeur
En-tête
Renbase.h (include Streams.h)
Bibliothèque
Strmbase.lib (builds de vente au détail) ;
Strmbasd.lib (builds de débogage)

Voir aussi

CBaseRenderer, classe