Properti, Peristiwa, dan Metode KS

  • Artikel

Arsitektur streaming kernel mendukung interaksi antara minidriver dan klien mode pengguna melalui properti, peristiwa, dan metode. Dengan menggunakan konstruksi ini, klien objek KS bisa mendapatkan dan mengatur status objek, mendaftarkan panggilan balik pemberitahuan untuk peristiwa, dan menjalankan metode objek.

Klien meminta ketiga kelas operasi secara standar. Klien menyediakan struktur alias KSIDENTIFIER dalam panggilan ke DeviceIoControl (dijelaskan dalam dokumentasi Microsoft Windows SDK) atau KsSynchronousDeviceControl.

Struktur aliasnya adalah KSPROPERTY, KSEVENT, dan KSMETHOD. Ketiganya mencakup parameter berikut:

  • Tetapkan

    Operasi serupa secara fungsional dikelompokkan bersama dalam satu set. Setiap properti, peristiwa, atau set metode diidentifikasi oleh GUID. Microsoft mendefinisikan GUID untuk operasi khusus teknologi standar. Minidriver dapat menentukan GUID mereka sendiri untuk operasi kustom.

  • Pengidentifikasi

    Setiap operasi ditentukan oleh nomor ID dalam set.

  • Data identifikasi khusus operasi

    Permintaan properti tertentu memerlukan data tambahan. Misalnya, pin pada perangkat audio mendukung kumpulan properti KSPROPSETID_Audio . Pin audio dapat mendukung beberapa saluran audio yang berbeda. Klien yang mendapatkan atau mengatur properti KSPROPSETID_Audio tertentu harus menentukan saluran audio tempat permintaan diterapkan. Permintaan peristiwa dan metode tidak memerlukan data tambahan.

GUID dan pengidentifikasi yang ditentukan Microsoft untuk operasi tujuan umum terletak di header ks.h. GUID standar dan pengidentifikasi untuk kelas teknologi multimedia tertentu ditemukan di ksmedia.h.

Minidriver AVStream mendukung properti, peristiwa, dan metode dengan menyediakan penunjuk ke struktur KSAUTOMATION_TABLE dalam KSFILTER_DESCRIPTOR atau KSPIN_DESCRIPTOR_EX yang relevan. KSAUTOMATION_TABLE berisi penunjuk ke array objek KSPROPERTY_SET . Untuk mempelajari selengkapnya, lihat Menentukan Tabel Automation.

Bagian ini berisi informasi tentang bagaimana minidriver mendukung tiga kelas operasi:

Properti KS

Peristiwa KS

Metode KS