struktur KSPROPERTY_TUNER_STATUS_S (ksmedia.h)

  • Artikel

Struktur KSPROPERTY_TUNER_STATUS_S menjelaskan kemajuan operasi penyetelan untuk perangkat tv dan tuner radio, termasuk frekuensi penyetelan saat ini.

Sintaks

typedef struct {
  KSPROPERTY Property;
  ULONG      CurrentFrequency;
  ULONG      PLLOffset;
  ULONG      SignalStrength;
  ULONG      Busy;
} KSPROPERTY_TUNER_STATUS_S, *PKSPROPERTY_TUNER_STATUS_S;

Anggota

Property

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

CurrentFrequency

Menentukan frekuensi tuner saat ini. Nilai ini dalam hertz (Hz).

PLLOffset

Menentukan offset loop terkunci fase (PLL) dalam kelipatan granularitas penyetelan. Ini digunakan jika strategi tuner KS_TUNER_STRATEGY_PLL. Jika strategi tuner tidak KS_TUNER_STRATEGY_PLL, nilai ini tidak memiliki arti. Tabel berikut menunjukkan nilai yang akan dikembalikan oleh minidriver untuk berbagai kondisi penyetelan, dengan asumsi granularitas penyetelan adalah 62,5kHz:

Offset Frekuensi PLLOffset
+125,000 +2
+62,500 +1
Disetel dengan sempurna 0
-62,500 -1
-125,000 -2

SignalStrength

Menentukan amplitude sinyal. Ini digunakan jika strategi tuner KS_TUNER_STRATEGY_SIGNAL_STRENGTH. Terlepas dari strategi penyetelan yang didukung oleh minidriver, nilai yang valid untuk anggota ini adalah:

Nilai Makna
-1 Kekuatan tidak Tersedia.
0 Tidak pada frekuensi yang dapat diterima.
1 Pada frekuensi yang dapat diterima.

Busy

Menunjukkan apakah minidriver saat ini sibuk dengan proses penyetelan. Anggota ini harus diatur ke TRUE jika minidriver saat ini sedang menyetel ke saluran. Jika tidak, jika minidriver saat ini tidak menyetel ke saluran baru, anggota ini harus diatur ke FALSE.

Keterangan

Untuk informasi selengkapnya tentang anggota PLLOffset dan SignalStrength , lihat pengambilan TV berbasis PCI. Jika perangkat tuner Anda mendukung penyetelan radio, lihat Perangkat Pengambilan Video dengan Penyetel Radio.

Persyaratan

Persyaratan Nilai
Header ksmedia.h (termasuk Ksmedia.h)

Lihat juga

KSPROPERTY

KSPROPERTY_TUNER_STATUS

PROPSETID_TUNER