KSPROPERTY_TUNER_STATUS_S structure (ksmedia.h)
La structure KSPROPERTY_TUNER_STATUS_S décrit la progression d’une opération de réglage pour les tuner tv et radio, y compris la fréquence de réglage actuelle.
Syntaxe
typedef struct {
KSPROPERTY Property;
ULONG CurrentFrequency;
ULONG PLLOffset;
ULONG SignalStrength;
ULONG Busy;
} KSPROPERTY_TUNER_STATUS_S, *PKSPROPERTY_TUNER_STATUS_S;
Membres
Property
Spécifie une structure KSPROPERTY initialisée qui décrit le jeu de propriétés, l’ID de propriété et le type de demande.
CurrentFrequency
Spécifie la fréquence actuelle du tuner. Cette valeur est en hertz (Hz).
PLLOffset
Spécifie le décalage de boucle verrouillée de phase (PLL) en plusieurs de la granularité de réglage. Elle est utilisée si la stratégie d’accordeur est KS_TUNER_STRATEGY_PLL. Si la stratégie d’accordeur n’est pas KS_TUNER_STRATEGY_PLL, cette valeur n’a aucune signification. Le tableau suivant illustre la valeur à retourner par le minidriver pour diverses conditions de réglage, en supposant que la granularité de réglage est de 62,5 kHz :
| Décalage de fréquence | PLLOffset |
|---|---|
| +125,000 | +2 |
| +62,500 | +1 |
| Parfaitement paramétré | 0 |
| -62,500 | -1 |
| -125,000 | -2 |
SignalStrength
Spécifie l’amplitude du signal. Il est utilisé si la stratégie d’accordeur est KS_TUNER_STRATEGY_SIGNAL_STRENGTH. Quelle que soit la stratégie de réglage prise en charge par le minidriver, les valeurs valides pour ce membre sont les suivantes :
| Valeur | Signification |
|---|---|
| -1 | Force non disponible. |
| 0 | Non sur une fréquence acceptable. |
| 1 | Sur une fréquence acceptable. |
Busy
Indique si le minidriver est actuellement occupé par le processus de réglage. Ce membre doit être défini sur TRUE si le minidriver est en cours de réglage sur un canal. Sinon, si le minidriver n’est pas actuellement paramétré sur un nouveau canal, ce membre doit avoir la valeur FALSE.
Remarques
Pour plus d’informations sur les membres PLLOffset et SignalStrength , consultez Capture TV basée sur PCI. Si votre appareil tuner prend en charge le réglage radio, consultez Appareils de capture vidéo avec tuners radio.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ksmedia.h (incluez Ksmedia.h) |