KSPROPERTY_TUNER_STATUS_S Struktur (ksmedia.h)
Die KSPROPERTY_TUNER_STATUS_S Struktur beschreibt den Fortschritt eines Optimierungsvorgangs für Tv- und Radio-Tunergeräte, einschließlich der aktuellen Tuninghäufigkeit.
Syntax
typedef struct {
KSPROPERTY Property;
ULONG CurrentFrequency;
ULONG PLLOffset;
ULONG SignalStrength;
ULONG Busy;
} KSPROPERTY_TUNER_STATUS_S, *PKSPROPERTY_TUNER_STATUS_S;
Angehörige
Property
Gibt eine initialisierte KSPROPERTY- Struktur an, die den Eigenschaftensatz, die Eigenschaften-ID und den Anforderungstyp beschreibt.
CurrentFrequency
Gibt die aktuelle Tunerfrequenz an. Dieser Wert ist in Hertz (Hz).
PLLOffset
Gibt den PLL-Offset (Phase Locked Loop) in Vielfachen der Optimierungs granularitä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. Die folgende Tabelle zeigt den Wert, der vom Minidriver für verschiedene Optimierungsbedingungen zurückgegeben werden soll, vorausgesetzt, die Granularität der Optimierung beträgt 62,5kHz:
| Frequenzversatz | 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 | Festigkeit nicht verfügbar. |
| 0 | Nicht auf einer akzeptablen Häufigkeit. |
| 1 | Auf einer akzeptablen Häufigkeit. |
Busy
Gibt an, ob der Minidriver derzeit mit dem Optimierungsprozess beschäftigt ist. Dieses Mitglied muss auf TRUE- festgelegt werden, wenn der Minidriver derzeit auf einen Kanal abgestimmt ist. Andernfalls muss dieses Mitglied auf FALSE-festgelegt werden, wenn der Minidriver derzeit nicht auf einen neuen Kanal abgestimmt ist.
Bemerkungen
Weitere Informationen zu den PLLOffset- und SignalStrength Mitgliedern finden Sie PCI-basierte TV-Aufnahme. Wenn Ihr Tunergerät die Funkoptimierung unterstützt, lesen Sie Videoaufnahmegeräte mit Radio Tuners.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ksmedia.h (enthalten Ksmedia.h) |