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.

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

Siehe auch

Fehler- und Erfolgscodes

IBaseFilter

IMediaFilter-Schnittstelle