Partager via

KSPROPERTY_TUNER_STATUS_S structure (ksmedia.h)

  • Article

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)

Voir aussi

KSPROPERTY

KSPROPERTY_TUNER_STATUS

PROPSETID_TUNER