Antarmuka IEncoderAPI (strmif.h)
[Fitur yang terkait dengan halaman ini, Microsoft TV Technologies, adalah fitur warisan. Microsoft sangat menyarankan agar kode baru tidak menggunakan fitur ini.]
[IEncoderAPI tidak lagi tersedia untuk digunakan. Sebagai gantinya, gunakan ICodecAPI.]
Antarmuka IEncoderAPI mendefinisikan cara standar bagi aplikasi dan driver untuk berkomunikasi dengan encoder perangkat keras atau perangkat lunak pihak ketiga yang mengimplementasikan antarmuka. Untuk informasi selengkapnya tentang antarmuka ini, lihat Encoder API.
Warisan
Antarmuka IEncoderAPI mewarisi dari antarmuka IUnknown . IEncoderAPI juga memiliki jenis anggota ini:
- Metode
Metode
Antarmuka IEncoderAPI memiliki metode ini.
| IEncoderAPI::GetDefaultValue Metode GetDefaultValue mengambil nilai default untuk parameter, jika ada. |
| IEncoderAPI::GetParameterRange Metode GetParameterRange mengambil rentang nilai valid yang didukung parameter, dalam kasus di mana parameter mendukung rentang yang dilangkahi dibandingkan dengan daftar nilai tertentu. |
| IEncoderAPI::GetParameterValues Metode GetParameterValues mengambil daftar nilai yang didukung oleh parameter yang diberikan. |
| IEncoderAPI::GetValue Metode GetValue mengambil nilai parameter yang ditentukan saat ini. |
| IEncoderAPI::IsAvailable IEncoderAPI tidak lagi tersedia untuk digunakan. (IEncoderAPI.IsAvailable) |
| IEncoderAPI::IsSupported Metode IsSupported mengkueri apakah parameter tertentu didukung. |
| IEncoderAPI::SetValue Metode SetValue menetapkan nilai parameter saat ini. |
Keterangan
Dalam berbagai metode antarmuka, GUID berikut, yang ditentukan dalam uuids.h, digunakan untuk menunjukkan parameter mana yang sedang diatur atau diambil.
| Parameter | Deskripsi |
|---|---|
| ENCAPIPARAM_BITRATE | Menentukan laju bit, dalam bit per detik. Dalam mode laju bit konstan (CBR), nilai memberikan laju bit konstan. Dalam salah satu mode laju bit variabel, ini memberikan laju bit rata-rata. Nilainya adalah panjang 32-bit yang tidak ditandatangani. |
| ENCAPIPARAM_PEAK_BITRATE | Menentukan laju bit puncak. Parameter ini hanya relevan ketika ENCAPIPARAM_BITRATE_MODE telah diatur ke VariableBitRatePeak. |
| ENCAPIPARAM_BITRATE_MODE | Menentukan mode laju bit, sebagai nilai enumerasi VIDEOENCODER_BITRATE_MODE (panjang 32-bit ditandatangani). |
Tabel berikut menjelaskan perilaku yang diharapkan dari encoder dalam kondisi laju bit yang sangat tinggi atau rendah dalam dua mode laju bit variabel yang ditentukan dalam VIDEOENCODER_BITRATE_MODE.
| Kondisi | Mode | Aktivitas |
|---|---|---|
| Adegan jatuh ke hitam atau tidak ada gerakan | VariableBitRateAverage | Dalam waktu singkat (beberapa detik) laju bit akan berada di bawah laju yang ditentukan untuk parameter ENCAPIPARAM_BITRATE. Tetapi selama periode waktu empat menit, encoder akan mempertahankan laju rata-rata, jika perlu dengan menambahkan bit "dummy" ke aliran. |
| Adegan jatuh ke hitam atau tidak ada gerakan. | VariableBitRatePeak | Laju bit akan berada di bawah laju yang diharapkan seperti yang ditentukan dalam nilai untuk parameter ENCAPIPARAM_BITRATE. Tingkat akan tetap pada tingkat itu sampai adegan yang lebih rumit dimulai. |
| Pemandangannya sangat kompleks. | VariableBitRateAverage | Selama beberapa detik tarif akan naik. Jika adegan tetap kompleks, laju akan kembali turun dan gambar akan menjadi blokir untuk mempertahankan rata-rata seperti yang ditentukan dalam nilai untuk parameter ENCAPIPARAM_BITRATE. |
| Pemandangannya sangat kompleks. | VariableBitRatePeak | Tarif akan naik dan tetap naik, mungkin di atas tarif yang diharapkan seperti yang ditentukan dalam nilai untuk parameter ENCAPIPARAM_BITRATE, tetapi tidak pernah di atas puncak seperti yang ditentukan dalam parameter ENCAPIPARAM_PEAK_BITRATE. |
Perangkat OCUR
Antarmuka ini mendukung perangkat OpenCable Unidirectional Cable Receiver (OCUR). Lihat Perangkat OCUR.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Windows |
| Header | strmif.h (termasuk Dshow.h) |