IMediaFilter::GetState-Methode (strmif.h)

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die GetState-Methode ruft den Status des Filters ab (wird ausgeführt, beendet oder angehalten).

Syntax

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

Parameter

[in] dwMilliSecsTimeout

Timeoutintervall in Millisekunden. Um unbegrenzt zu blockieren, verwenden Sie den Wert INFINITE.

[out] State

Empfängt einen Member des FILTER_STATE aufgezählten Typs, der den Status des Filters angibt.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Mögliche Werte sind die in der folgenden Tabelle gezeigten Werte.

Rückgabecode Beschreibung
S_OK
 Erfolg.
E_POINTER
 NULL-Zeigerargument.
VFW_S_STATE_INTERMEDIATE
 Zwischenzustand.
VFW_S_CANT_CUE
 Der Filter ist aktiv, kann aber keine Daten liefern.

Bemerkungen

Zustandsübergänge können asynchron sein. Wenn der Filter in einen neuen Zustand wechselt und die Methode ein Zeitüberschreitung aufweist, bevor der Übergang abgeschlossen ist, gibt die Methode VFW_S_STATE_INTERMEDIATE zurück.

Wenn ein Filter aus irgendeinem Grund keine Daten liefern kann, gibt er VFW_S_CANT_CUE zurück. Liveerfassungsfilter geben diesen Wert angehalten zurück, da sie keine Daten im angehaltenen Zustand übermitteln.

Weitere Informationen finden Sie unter Datenfluss im Filterdiagramm.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Siehe auch

Fehler- und Erfolgscodes

IBaseFilter

IMediaFilter-Schnittstelle