IOCTL_KS_PROPERTY IOCTL (ks.h)

Artikel
02/26/2024

Aplikasi dapat menggunakan IOCTL_KS_PROPERTY untuk mendapatkan atau mengatur properti, atau untuk menentukan properti yang didukung oleh objek KS. Aplikasi meneruskan IOCTL_KS_PROPERTY dengan parameter yang dijelaskan di bawah ini ke fungsi KsSynchronousDeviceControl .

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Konten parameter InBuffer yang ditentukan klien bergantung pada permintaan properti, dan didokumentasikan untuk setiap set properti. Misalnya, klien yang meminta properti dalam kumpulan properti KSPROPSETID_Pin menentukan penunjuk ke struktur KSP_PIN .

Panjang buffer input

Aplikasi menempatkan ukuran, dalam byte, dari konten buffer input dalam parameter InLength .

Buffer output

Demikian pula, jenis buffer output yang diperlukan juga tergantung pada permintaan properti.

Panjang buffer output

Aplikasi menempatkan ukuran, dalam byte, dari buffer output di parameter OutLength .

Blok status

Jika permintaan berhasil, anggota Status diatur ke STATUS_SUCCESS.

Keterangan

Untuk informasi selengkapnya tentang buffer input dan output dan ukurannya, lihat Properti KS.

Filter dan pin mendukung kumpulan properti menggunakan kontrol I/O perangkat IOCTL_KS_PROPERTY . Meskipun IOCTL ini didefinisikan dengan bendera METHOD_NEITHER, data properti diteruskan sebagai buffer output ke IOCTL dan diselidiki untuk akses baca. Fungsi KsPropertyHandler menangani properti yang diminta melalui IOCTL_KS_PROPERTY.

Untuk daftar bendera yang valid dan deskripsi terkait, lihat halaman referensi untuk struktur KSPROPERTY .