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) |