structure KSPROPERTY_TUNER_STATUS_S (ksmedia.h)
La structure KSPROPERTY_TUNER_STATUS_S décrit la progression d’une opération de réglage pour les appareils 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 de KSPROPERTY initialisée qui décrit le jeu de propriétés, l’ID de propriété et le type de requête.
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) dans plusieurs des granularités de réglage. Cela est utilisé si la stratégie de réglage est KS_TUNER_STRATEGY_PLL. Si la stratégie de réglage n’est pas KS_TUNER_STRATEGY_PLL, cette valeur n’a aucune signification. Le tableau suivant illustre la valeur à retourner par le minidriver pour différentes 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. Cela est utilisé si la stratégie de réglage 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 | Pas 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 actuellement paramétré sur un canal. Sinon, si le minidriver n’est pas actuellement paramétré sur un nouveau canal, ce membre doit être défini sur FALSE.
Remarques
Pour plus d’informations sur les membres PLLOffset et SignalStrength, consultez capture de tv basée sur PCI. Si votre appareil de réglage prend en charge le réglage radio, consultez Appareils de capture vidéo avec radio tuners.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ksmedia.h (include Ksmedia.h) |