Freigeben über


CBaseRenderer.GetState-Methode

[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 der Filter ab (wird ausgeführt, beendet oder angehalten).

Syntax

HRESULT GetState(
   DWORD        dwMilliSecsTimeout,
   FILTER_STATE *State
);

Parameter

dwMilliSecsTimeout

Timeoutintervall in Millisekunden.

State

Zeiger auf eine Variable, die einen Member des FILTER_STATE aufgezählten Typs empfängt, der den Status des Filters angibt.

Rückgabewert

Gibt einen der in der folgenden Tabelle dargestellten HRESULT-Werte zurück.

Rückgabecode Beschreibung
S_OK
Erfolg.
VFW_S_STATE_INTERMEDIATE
Der Filter wechselt in den angegebenen Zustand.
E_POINTER
NULL-Zeigerargument.

Bemerkungen

Diese Methode überschreibt die CBaseFilter::GetState-Methode . Wenn der Renderer angehalten wird, schließt er den Zustandsübergang erst ab, wenn er ein beispiel zum Rendern erhält. Wenn das Timeout abläuft, bevor der Zustandsübergang abgeschlossen ist, gibt die Methode VFW_S_STATE_INTERMEDIATE zurück.

Anforderungen

Anforderung Wert
Header
Renbase.h (einschließlich Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CBaseRenderer-Klasse