ICodecAPI::Metode GetParameterRange (icodecapi.h)

Artikel
08/24/2023

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,
        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.

ValueMax

[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.

Menampilkan 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


Klien minimum yang didukung	Windows 10 Build 20348
Server minimum yang didukung	Windows 10 Build 20348
Header	icodecapi.h

Lihat juga

Referensi API Codec

Encoder API

ICodecAPI

Bagikan melalui