CBaseMediaFilter.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 Zustand des Objekts ab (wird ausgeführt, beendet oder angehalten). Diese Methode implementiert die IMediaFilter::GetState-Methode .

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 Zustand des Objekts angibt.

Rückgabewert

Gibt S_OK oder E_POINTER zurück.

Bemerkungen

In der Basisklasse sind alle Zustandsübergänge synchron, und der dwMilliSecsTimeout-Parameter wird ignoriert. Wenn eine abgeleitete Klasse asynchrone Zustandsübergänge ausführt, sollte sie diese Methode überschreiben, um während Zustandsübergängen mit einem Timeout von dwMilliSecsTimeout Millisekunden zu warten.

Anforderungen

Anforderung	Wert
Header	Amfilter.h (include Streams.h)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)

Siehe auch

CBaseMediaFilter-Klasse