ICodecAPI::Metode GetParameterRange (strmif.h)

Artikel
07/28/2023

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan 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 Audio/Video Capture 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 GetParameterRange mendapatkan rentang nilai untuk properti codec.

Metode ini hanya berlaku untuk properti yang nilainya membentuk rentang linier.

Sintaks

HRESULT GetParameterRange(
  [in]  const GUID *Api,
  [out] VARIANT    *ValueMin,
  [out] VARIANT    *ValueMax,
  [out] VARIANT    *SteppingDelta
);

Parameter

[in] Api

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

[out] ValueMin

Penunjuk ke VARIAN yang menerima nilai minimum properti. Pemanggil harus membebaskan VARIAN dengan memanggil VariantClear.

[out] ValueMax

Penunjuk ke VARIAN yang menerima nilai maksimum properti. Pemanggil harus membebaskan VARIAN dengan memanggil VariantClear.

[out] SteppingDelta

Penunjuk ke VARIAN yang menerima delta langkah, yang menentukan kenaikan yang valid dari ValueMin ke ValueMax. Pemanggil harus membebaskan VARIAN dengan memanggil VariantClear.

Jika jenis VARIAN VT_EMPTY, kenaikan apa pun valid.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
E_INVALIDARG	Argumen tidak valid.
S_OK	Metode berhasil.
VFW_E_CODECAPI_ENUMERATED	Properti mendukung daftar nilai yang mungkin, bukan rentang linier.

Keterangan

Rentang yang valid untuk properti adalah [ValueMin... ValueMax], dengan kenaikan SteppingDelta. Jika properti mendukung rentang nilai linier, properti harus menggunakan salah satu jenis varian berikut:

Jenis yang tidak ditandatangani: VT_UI8, VT_UI4, VT_UI2, VT_UI1
Jenis yang ditandatangani: VT_I8, VT_I4, VT_I2
Jenis titik mengambang: VT_R8, VT_R4

Jika properti mendukung daftar nilai, bukan rentang, metode mengembalikan VFW_E_CODECAPI_ENUMERATED. Dalam hal ini, panggil ICodecAPI::GetParameterValues untuk mendapatkan daftar nilai.

Persyaratan

Persyaratan	Nilai
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