ICodecAPI::Metode GetParameterValues (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 GetParameterValues mendapatkan daftar nilai yang mungkin untuk properti codec.

Metode ini hanya berlaku untuk properti yang mendukung daftar nilai yang mungkin, dibandingkan dengan rentang linier.

Sintaks

HRESULT GetParameterValues(
  [in]  const GUID *Api,
  [out] VARIANT    **Values,
  [out] ULONG      *ValuesCount
);

Parameter

[in] Api

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

[out] Values

Menerima penunjuk ke array jenis VARIAN . Array berisi daftar nilai yang didukung encoder untuk properti ini. Pemanggil harus membebaskan setiap VARIAN dengan memanggil VariantClear. Pemanggil juga harus membebaskan array dengan memanggil CoTaskMemFree.

[out] ValuesCount

Menerima jumlah elemen dalam array Nilai .

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Argumen tidak valid.
VFW_E_CODECAPI_LINEAR_RANGE	Properti mendukung rentang nilai, bukan daftar.

Keterangan

Jika properti mendukung rentang nilai, bukan daftar, metode akan mengembalikan VFW_E_CODECAPI_LINEAR_RANGE. Dalam hal ini, panggil ICodecAPI::GetParameterRange untuk mendapatkan rentang nilai.

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

Referensi API Codec

Encoder API

ICodecAPI

Bagikan melalui