ICodecAPI::GetAllSettings-Methode (strmif.h)

  • Artikel

[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
S_OK
 Die Methode wurde erfolgreich ausgeführt.
E_NOTIMPL
 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

Weitere Informationen

Codec-API-Referenz

Encoder-API

ICodecAPI