ICodecAPI::GetAllSettings-Methode (strmif.h)
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Die GetAllSettings-Methode ruft die aktuellen Eigenschaften des Codecs ab und schreibt sie in einen Stream.
Syntax
HRESULT GetAllSettings(
[in] IStream *__MIDL__ICodecAPI0000
);
Parameter
[in] __MIDL__ICodecAPI0000
Zeiger auf die IStream-Schnittstelle des Streams.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
Rückgabecode | BESCHREIBUNG |
---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Nicht implementiert. |
Hinweise
Codecs, die ICodecAPI implementieren, sind nicht erforderlich, um diese Methode zu unterstützen.
Um die Eigenschaften aus dem Stream wieder auf den Codec zu laden, rufen Sie ICodecAPI::SetAllSettings oder ICodecAPI::SetAllSettingsWithNotify auf.
Das Format der Daten, die in den Stream geschrieben werden, hängt von der Implementierung des Codecs ab. Es gibt kein Standardserialisierungsformat. Eine Anwendung sollte nicht versuchen, die Eigenschaften aus einem Codec zu speichern und auf einen anderen Codec zu laden.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows XP mit SP2 [Desktop-Apps | UWP-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 R2 [Desktop-Apps | UWP-Apps] |
Zielplattform | Windows |
Kopfzeile | strmif.h (include Dshow.h) |
Bibliothek | Strmiids.lib |