Implementasi dan Dukungan Encoder

Di Windows XP Service Pack 1, Microsoft menentukan tiga set properti streaming kernel dan satu enumerasi di ksmedia.h untuk mendukung perangkat encoder khusus video. Setiap kumpulan properti berisi satu properti. Dengan kata lain, setiap properti menerima kumpulan propertinya sendiri. Jika driver Anda melakukan panggilan get-property atau Set-property, tentukan GUID kumpulan properti (seperti yang didefinisikan dalam ksmedia.h) di Set anggota struktur KSPROPERTY dan nol di anggota Id saat Anda menyiapkan panggilan:

Set Properti	Deskripsi
ENCAPIPARAM_BITRATE	Terapkan properti ini untuk mengatur laju bit penyandian yang didukung oleh perangkat encoder. Lihat Contoh Kode Encoder untuk detail selengkapnya.
ENCAPIPARAM_BITRATE_MODE	Tetapkan set properti ini untuk menentukan mode enkoding yang didukung oleh perangkat. Kumpulan properti ini menggunakan enumerasi VIDEOENCODER_BITRATE_MODE untuk menentukan mode yang didukung. Lihat Contoh Kode Encoder untuk detail selengkapnya.
ENCAPIPARAM_PEAK_BITRATE	Terapkan set properti ini untuk menentukan laju bit pengodean maksimum perangkat.

Klien mengakses properti ini dengan memperoleh antarmuka IVideoEncoder COM dari antarmuka IEncoderAPI COM (dijelaskan dalam dokumentasi Windows Software Development Kit (SDK).

Minidriver harus menentukan nilai default untuk setiap properti ENCAPIPARAM_Xxx . Topik Contoh Kode Encoder menunjukkan cara menentukan nilai properti default. Selama pengembangan dan pemecahan masalah filter encoder, halaman properti yang sedang digunakan dapat dipicu dari minidriver yang mendukung set properti ENCAPIPARAM_BITRATE.

Di DirectX 9.0, enam set properti tambahan dan satu set peristiwa didefinisikan dalam ksmedia.h untuk memberikan dukungan yang lebih baik untuk berbagai encoder yang lebih luas, termasuk encoder audio saja. Seperti halnya properti ENCAPIPARAM_Xxx , setiap properti menerima kumpulan propertinya sendiri:

Set Properti	Deskripsi
CODECAPI_VIDEO_ENCODER	Jika perangkat Anda mendukung pengodean aliran video (termasuk audio tambahan seperti audio TV) maka terapkan dukungan untuk set properti ini.
CODECAPI_AUDIO_ENCODER	Jika perangkat Anda adalah encoder audio saja, maka terapkan dukungan untuk kumpulan properti ini alih-alih CODECAPI_VIDEO_ENCODER.
CODECAPI_SETALLDEFAULTS	Terapkan properti ini diatur untuk mengatur ulang semua pengaturan internal perangkat encoder, seperti mengodekan laju bit dan mode pengodean ke nilai defaultnya.
CODECAPI_ALLSETTINGS	Menerapkan set properti ini untuk menyampaikan pengaturan perangkat encoder saat ini. Kumpulan properti ini digunakan untuk komunikasi ke dan dari klien.
CODECAPI_SUPPORTSEVENTS	Jika perangkat Anda mendukung peristiwa dari mode pengguna--seperti mengubah mode pengodean, laju bit, atau pengaturan lainnya--maka terapkan kumpulan properti ini. Jika Anda menerapkan kumpulan properti ini, maka Anda juga harus menerapkan dukungan untuk acara CODECAPI_CHANGELISTS.
CODECAPI_CURRENTCHANGELIST	Terapkan properti ini untuk menentukan parameter encoder mana yang diubah dalam panggilan sebelumnya yang mengatur satu atau beberapa properti encoder.

Kumpulan Acara	Deskripsi
CODECAPI_CHANGELISTS	Jika perangkat mendukung respons terhadap peristiwa mode pengguna melalui kumpulan properti CODECAPI_SUPPORTSEVENTS, maka terapkan set peristiwa ini untuk mengembalikan daftar pengaturan encoder yang telah berubah sebagai hasil dari panggilan Set-property sebelumnya klien ke CODECAPI_SETALLDEFAULTS atau CODECAPI_ALLSETTINGS.

Klien mengakses properti ini melalui antarmuka ICodecAPI COM (dijelaskan dalam dokumentasi Windows SDK). Lihat Penginstalan dan Pendaftaran Encoder untuk informasi selengkapnya tentang antarmuka COM, termasuk cara menentukan antarmuka mana yang harus diekspos KsProxy.

Minidriver harus menerapkan dukungan untuk kueri get-property dasar. Topik Contoh Kode Encoder menunjukkan cara mendukung kueri get-property.

Saat mengembangkan filter encoder, pindahkan fungsi pengodean ke filter terpisah dari filter pengambilan video. Tentukan media privat Anda sendiri sehingga penyusun grafik dapat menyambungkan encoder dan menangkap filter dengan benar. Jika perangkat keras Anda mampu menguasai konten bus yang tidak dikodekan, maka Anda juga dapat mengekspos media publik. Jika Anda menerapkan media publik dan privat, maka cantumkan media privat terlebih dahulu karena mengurangi waktu pembangunan grafik; untuk menemukan filter yang benar saat membuat grafik filter.

Untuk informasi lebih lanjut tentang penggunaan media dan beberapa instance filter (dalam diagram filter terpisah), lihat Media dan Kategori.