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 |
|
| Bibliothek |
|