Bagikan melalui


Set Properti Encoder

Bagian ini menjelaskan kumpulan properti khusus API encoder dan codec yang tersedia untuk minidriver encoder yang menggunakan layanan streaming kernel WDM di Microsoft Windows 98/Me, Windows 2000, dan Windows XP dan yang lebih baru.

Halaman referensi untuk setiap properti berisi tabel dengan judul kolom yang diperlihatkan di bawah ini.

Get Set Target Jenis deskriptor properti Jenis nilai properti

Judul ini memiliki arti berikut:

  • Get

    Apakah objek KS target mendukung permintaan properti KSPROPERTY_TYPE_GET?

  • Set

    Apakah objek KS target mendukung permintaan properti KSPROPERTY_TYPE_SET?

  • Target

    Ini adalah objek KS tempat permintaan properti dikirim. Target untuk properti encoder video adalah filter atau pin. (Permintaan properti menentukan objek target dengan handel kernelnya.)

  • Jenis deskriptor properti

    Deskriptor properti menentukan properti dan operasi yang akan dilakukan pada properti tersebut. The descriptor always begins with a KSPROPERTY structure.

  • Jenis nilai properti

    Properti memiliki nilai dan jenis nilai ini tergantung pada properti . Misalnya, properti yang hanya dapat berada di salah satu dari dua status--on atau off--biasanya memiliki nilai BOOL. Properti yang dapat mengasumsikan nilai bilangan bulat dari 0x0 ke 0xFFFFFFFF mungkin memiliki nilai ULONG. Properti yang lebih kompleks mungkin memiliki nilai yang merupakan array atau struktur.

Deskriptor properti dan nilai properti di atas adalah versi khusus properti dari buffer spesifikasi instans dan data operasi yang dibahas dalam Properti, Peristiwa, dan Metode KS.

Permintaan properti menggunakan salah satu bendera berikut untuk menentukan operasi yang akan dilakukan pada properti:

  • KSPROPERTY_TYPE_BASICSUPPORT

  • KSPROPERTY_TYPE_GET

  • KSPROPERTY_TYPE_SET

Semua objek filter dan sematkan mendukung operasi dukungan dasar pada propertinya. Whether they support the get and Set operations depends on the property. A property that represents an inherent capability of the filter or pin object is likely to require only a get operation. A property that represents a configurable setting might require only a Set operation, although a get operation might also be useful for reading the current setting. For more information about using the get, set, and basic-support operations with video encoder properties, see KS Properties.

Tabel dalam deskripsi setiap properti menunjukkan apakah minidriver encoder video diperlukan untuk mendukung pembacaan atau penulisan properti. Minidriver encoder video harus mengembalikan STATUS_NOT_SUPPORTED sebagai respons untuk mendapatkan atau mengatur permintaan untuk properti yang tidak didukung oleh minidriver.

Properti berikut menetapkan masing-masing berisi satu properti yang harus diimplementasikan oleh minidriver encoder video. That is, effectively each property gets its own set, so specify 0 in the PropertyId member of the KSPROPERTY_ITEM member in the KSPROPERTY_SET structure as required.

Kumpulan properti berikut milik API codec:

CODECAPI_VIDEO_ENCODER

CODECAPI_AUDIO_ENCODER

CODECAPI_SETALLDEFAULTS

CODECAPI_ALLSETTINGS

CODECAPI_SUPPORTSEVENTS

CODECAPI_CURRENTCHANGELIST

Set properti berikut milik API encoder:

ENCAPIPARAM_BITRATE

ENCAPIPARAM_BITRATE_MODE

ENCAPIPARAM_PEAK_BITRATE