IMediaFilter::GetState-Methode (strmif.h)
[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 |
|---|---|
|
Erfolg. |
|
NULL-Zeigerargument. |
|
Zwischenzustand. |
|
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 |