ICodecAPI::SetValueWithNotify-Methode (strmif.h)

Artikel
07/28/2023

[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 SetValueWithNotify-Methode legt eine Eigenschaft für einen Codec fest und gibt eine Liste anderer Eigenschaften zurück, die sich dadurch geändert haben.

Syntax

HRESULT SetValueWithNotify(
  [in]  const GUID *Api,
  [in]  VARIANT    *Value,
  [out] GUID       **ChangedParam,
  [out] ULONG      *ChangedParamCount
);

Parameter

[in] Api

Zeiger auf eine GUID, die die festzulegende Eigenschaft angibt. Eine Liste der Standardcodeceigenschaften finden Sie unter Codec-API-Eigenschaften.

[in] Value

Zeiger auf einen VARIANT-Wert , der den neuen Wert für die -Eigenschaft enthält.

[out] ChangedParam

Empfängt einen Zeiger auf ein Array von GUIDs. Das Array enthält die GUIDs aller Eigenschaften, die sich infolge dieses Methodenaufrufs geändert haben. Der Aufrufer muss das Array durch Aufrufen von CoTaskMemFree freigeben.

[out] ChangedParamCount

Empfängt die Anzahl der Elemente im ChangedParam-Array .

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.

Bemerkungen

Codecs, die ICodecAPI implementieren, sind nicht erforderlich, um diese Methode zu unterstützen.

Anforderungen


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

Siehe auch