struktur KSPROPERTY_TUNER_SCAN_CAPS_S (ksmedia.h)

Artikel
02/29/2024

Struktur KSPROPERTY_TUNER_SCAN_CAPS_S menjelaskan kemampuan pemindaian perangkat keras dari perangkat penyetelan.

Sintaks

typedef struct {
  KSPROPERTY Property;
  BOOL       fSupportsHardwareAssistedScanning;
  ULONG      SupportedBroadcastStandards;
  PVOID      GUIDBucket;
  ULONG      lengthofBucket;
} KSPROPERTY_TUNER_SCAN_CAPS_S, *PKSPROPERTY_TUNER_SCAN_CAPS_S;

Anggota

Property

Menentukan struktur KSPROPERTY yang diinisialisasi yang menjelaskan kumpulan properti, ID properti, dan jenis permintaan.

fSupportsHardwareAssistedScanning

Nilai Boolean yang menunjukkan apakah driver atau firmware untuk tuner mendukung operasi pemindaian yang dibantu perangkat keras. TRUE menunjukkan bahwa driver atau firmware untuk tuner mendukung operasi pemindaian yang dibantu perangkat keras. FALSE menunjukkan bahwa driver atau firmware tidak mendukung operasi pemindaian yang dibantu perangkat keras.

SupportedBroadcastStandards

Jumlah jenis standar video siaran yang dapat didukung perangkat penyetelan. Tuner hibrid dapat mendukung beberapa jenis.

GUIDBucket

Array GUID untuk jenis jaringan yang didukung perangkat penyetelan.

Berdasarkan nomor yang didukung di SupportedBroadcastStandards yang dikembalikan dalam panggilan awal ke properti KSPROPERTY_TUNER_SCAN_CAPS , filter tuner analog atau digital kemudian mengalokasikan array GUID. Driver menggunakan buffer pengguna yang dialokasikan ini untuk mengembalikan semua GUID yang didukung dalam panggilan berikutnya ke KSPROPERTY_TUNER_SCAN_CAPS. Driver harus memanggil fungsi ProbeForWrite untuk memvalidasi buffer pengguna ini dan harus memastikan bahwa panjang buffer valid. Meskipun tidak mungkin, jika driver akan mengakses buffer ini dalam utas arbitrer, itu harus memetakan buffer ke ruang kernel. Saat ini, kemampuan pemindaian didefinisikan untuk mendukung standar analog. Jika driver mendukung analog dan aplikasi berniat memulai sesi pemindaian untuk analog, kemampuan yang sesuai ditentukan oleh properti KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS . Kemampuan pemindaian lainnya untuk mendukung standar siaran lain (misalnya, DVB-S) belum didukung.

lengthofBucket

Jumlah GUID dalam array GUIDBucket .