Antarmuka ICodecAPI (icodecapi.h)

Artikel
03/16/2023

Antarmuka ICodecAPI mengatur dan mengambil pengaturan pada filter encoder atau decoder.

Warisan

Antarmuka ICodecAPI mewarisi dari antarmuka IUnknown.

Metode

Antarmuka ICodecAPI memiliki metode ini.


ICodecAPI::GetAllSettings Metode GetAllSettings mendapatkan properti codec saat ini dan menulisnya ke aliran. (ICodecAPI::GetAllSettings)
ICodecAPI::GetDefaultValue Metode GetDefaultValue mendapatkan nilai default properti codec. (ICodecAPI::GetDefaultValue)
ICodecAPI::GetParameterRange Metode GetParameterRange mendapatkan rentang nilai untuk properti codec. (ICodecAPI::GetParameterRange)
ICodecAPI::GetParameterValues Metode GetParameterValues mendapatkan daftar nilai yang mungkin untuk properti codec. (ICodecAPI::GetParameterValues)
ICodecAPI::GetValue Metode ICodecAPI::GetValue mendapatkan nilai properti codec saat ini.
ICodecAPI::IsModifiable Metode IsModifiable meminta apakah properti codec dapat diubah, mengingat konfigurasi codec saat ini. (ICodecAPI::IsModifiable)
ICodecAPI::IsSupported Metode IsSupported mengkueri apakah codec mendukung properti tertentu. (ICodecAPI::IsSupported)
ICodecAPI::RegisterForEvent Metode RegisterForEvent mendaftarkan aplikasi untuk menerima peristiwa dari codec. (ICodecAPI::RegisterForEvent)
ICodecAPI::SetAllDefaults Metode SetAllDefaults mengatur ulang semua properti codec ke nilai defaultnya. (ICodecAPI::SetAllDefaults)
ICodecAPI::SetAllDefaultsWithNotify Metode SetAllDefaultsWithNotify mengatur ulang semua properti codec ke nilai defaultnya, dan mengembalikan daftar properti yang berubah. (ICodecAPI::SetAllDefaultsWithNotify)
ICodecAPI::SetAllSettings Metode SetAllSettings membaca properti codec dari aliran dan mengaturnya di codec. (ICodecAPI::SetAllSettings)
ICodecAPI::SetAllSettingsWithNotify Metode SetAllSettingsWithNotify membaca properti codec dari aliran, mengaturnya di codec, dan mengembalikan daftar properti yang berubah. (ICodecAPI::SetAllSettingsWithNotify)
ICodecAPI::SetValue Metode SetValue menetapkan nilai properti codec. (ICodecAPI::SetValue)
ICodecAPI::SetValueWithNotify Metode SetValueWithNotify mengatur properti pada codec dan mengembalikan daftar properti lain yang berubah sebagai hasilnya. (ICodecAPI::SetValueWithNotify)
ICodecAPI::UnregisterForEvent Metode UnregisterForEvent membatalkan pendaftaran aplikasi untuk peristiwa encoder tertentu. (ICodecAPI::UnregisterForEvent)

Keterangan

Antarmuka ini mendefinisikan mekanisme generik untuk mengatur properti pada codec (encoder atau decoder). Properti codec adalah pasangan kunci/nilai, di mana kuncinya adalah GUID dan nilainya adalah VARIAN. Interpretasi data VARIAN tergantung pada GUID properti. Untuk daftar GUID properti codec, lihat Properti API Codec.

Profil Codec

Codec dapat secara opsional menyimpan informasi profil dan kemampuan di registri sistem. Informasi ini memungkinkan aplikasi untuk mengkueri perangkat selama enumerasi perangkat. Profil default disimpan dalam kunci registri berikut:

HKEY_LOCAL_MACHINE
   Software
      Classes
         CLSID
            Category
               Profiles

Setiap profil adalah kunci registri yang string defaultnya adalah deskripsi teks profil. Setiap nilai memiliki nama GUID, diikuti dengan nilai string yang berisi nilai GUID numerik. Contohnya:

C++
HLKM\Software\Classes\CLSID\<category>\Profiles\DVD default "HQ DVD" REG_SZ {...} = "0" REG_SZ {...} = "1234"

di mana {...} adalah GUID properti yang dapat dipetakan aplikasi ke antarmuka penggunanya. Microsoft saat ini sedang mempertimbangkan definisi sekumpulan profil standar.

Kemampuan codec default disimpan di bawah HLKM\Software\Classes\CLSID< category>\Instance< Filter CLSID>\Capabilities. Setiap nilai memiliki nama GUID, diikuti dengan nilai string yang berisi nilai GUID numerik. Contohnya:

C++
HLKM\Software\Classes\CLSID\<category>\Instance\<My DVD encoder>\Capabilities default "My DVD encoder" REG_SZ_MULTI {...}

di mana {...} adalah GUID properti yang dapat dipetakan aplikasi ke antarmuka penggunanya.

Persyaratan

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

Lihat juga

Encoder API

Bagikan melalui