ICodecAPI::SetValueWithNotify method (strmif.h)

Artikel
07/28/2023

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode SetValueWithNotify mengatur properti pada codec dan mengembalikan daftar properti lain yang berubah sebagai hasilnya.

Sintaks

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

Parameter

[in] Api

Penunjuk ke GUID yang menentukan properti yang akan diatur. Untuk daftar properti codec standar, lihat Properti API Codec.

[in] Value

Penunjuk ke VARIAN yang berisi nilai baru untuk properti .

[out] ChangedParam

Menerima penunjuk ke array GUID. Array berisi GUID dari properti apa pun yang berubah sebagai akibat dari panggilan metode ini. Pemanggil harus membebaskan array dengan memanggil CoTaskMemFree.

[out] ChangedParamCount

Menerima jumlah elemen dalam array ChangedParam .

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_NOTIMPL	Tidak diterapkan.

Keterangan

Codec yang mengimplementasikan ICodecAPI tidak diperlukan untuk mendukung metode ini.

Persyaratan


Klien minimum yang didukung	Windows XP dengan SP2 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Bagikan melalui