Freigeben über


KSPROPERTY_TUNER_STATUS_S-Struktur (ksmedia.h)

Die KSPROPERTY_TUNER_STATUS_S-Struktur beschreibt den Fortschritt eines Optimierungsvorgangs für TV- und Radiotunergeräte, einschließlich der aktuellen Optimierungsfrequenz.

Syntax

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

Member

Property

Gibt eine initialisierte KSPROPERTY-Struktur an, die den Eigenschaftensatz, die Eigenschafts-ID und den Anforderungstyp beschreibt.

CurrentFrequency

Gibt die aktuelle Tunerhäufigkeit an. Dieser Wert ist in Hertz (Hz).

PLLOffset

Gibt den PLL-Offset (Phase Locked Loop) in Vielfachen der Optimierungsgranularität an. Dies wird verwendet, wenn die Tunerstrategie KS_TUNER_STRATEGY_PLL ist. Wenn die Tunerstrategie nicht KS_TUNER_STRATEGY_PLL ist, hat dieser Wert keine Bedeutung. In der folgenden Tabelle wird der Wert veranschaulicht, der vom Minidriver für verschiedene Optimierungsbedingungen zurückgegeben werden soll, sofern die Optimierungsgranularität 62,5 kHz beträgt:

Frequenzoffset PLLOffset
+125,000 +2
+62,500 +1
Perfekt abgestimmt 0
-62,500 -1
-125,000 -2

SignalStrength

Gibt die Amplitude des Signals an. Dies wird verwendet, wenn die Tunerstrategie KS_TUNER_STRATEGY_SIGNAL_STRENGTH ist. Unabhängig von der optimierungsstrategie, die vom Minidriver unterstützt wird, sind die gültigen Werte für dieses Element:

Wert Bedeutung
-1 Stärke nicht verfügbar.
0 Nicht auf einer akzeptablen Häufigkeit.
1 Auf einer akzeptablen Häufigkeit.

Busy

Gibt an, ob der Minitreiber derzeit mit dem Optimierungsprozess beschäftigt ist. Dieser Member muss auf TRUE festgelegt werden, wenn der Minidriver derzeit auf einen Kanal abgestimmt ist. Andernfalls muss dieser Member auf FALSE festgelegt werden, wenn der Minitreiber derzeit nicht auf einen neuen Kanal abgestimmt ist.

Hinweise

Weitere Informationen zu den Mitgliedern PLLOffset und SignalStrength finden Sie unter PCI-basierte TV-Aufzeichnung. Wenn Ihr Tunergerät die Funkoptimierung unterstützt, lesen Sie Videoaufnahmegeräte mit Radiotunern.

Anforderungen

Anforderung Wert
Header ksmedia.h (include Ksmedia.h)

Weitere Informationen

KSPROPERTY

KSPROPERTY_TUNER_STATUS

PROPSETID_TUNER