Compartilhar via


estrutura KSPROPERTY_TUNER_STATUS_S (ksmedia.h)

A estrutura KSPROPERTY_TUNER_STATUS_S descreve o progresso de uma operação de ajuste para dispositivos sintonizadores de TV e rádio, incluindo a frequência de ajuste atual.

Sintaxe

typedef struct {
  KSPROPERTY Property;
  ULONG      CurrentFrequency;
  ULONG      PLLOffset;
  ULONG      SignalStrength;
  ULONG      Busy;
} KSPROPERTY_TUNER_STATUS_S, *PKSPROPERTY_TUNER_STATUS_S;

Membros

Property

Especifica uma estrutura KSPROPERTY inicializada que descreve o conjunto de propriedades, a ID da propriedade e o tipo de solicitação.

CurrentFrequency

Especifica a frequência atual do sintonizador. Esse valor está em hertz (Hz).

PLLOffset

Especifica o deslocamento pll (loop de bloqueio de fase) em múltiplos da granularidade de ajuste. Isso será usado se a estratégia do sintonizador for KS_TUNER_STRATEGY_PLL. Se a estratégia do sintonizador não for KS_TUNER_STRATEGY_PLL, esse valor não terá significado. A tabela a seguir demonstra o valor a ser retornado pelo minidriver para várias condições de ajuste, supondo que a granularidade de ajuste seja de 62,5kHz:

Deslocamento de frequência PLLOffset
+125,000 +2
+62,500 +1
Perfeitamente ajustado 0
-62,500 -1
-125,000 -2

SignalStrength

Especifica a amplitude do sinal. Isso será usado se a estratégia do sintonizador for KS_TUNER_STRATEGY_SIGNAL_STRENGTH. Independentemente da estratégia de ajuste com suporte do minidriver, os valores válidos para esse membro são:

Valor Significado
-1 Força não disponível.
0 Não em uma frequência aceitável.
1 Em uma frequência aceitável.

Busy

Indica se o minidriver está ocupado com o processo de ajuste. Esse membro deverá ser definido como TRUE se o minidriver estiver atualmente ajustando a um canal. Caso contrário, se o minidriver não estiver atualmente ajustando a um novo canal, esse membro deverá ser definido como FALSE.

Comentários

Para obter mais informações sobre os membros PLLOffset e SignalStrength , consulte Captura de TV baseada em PCI. Se o dispositivo sintonizador der suporte ao ajuste de rádio, consulte Dispositivos de captura de vídeo com sintonizadores de rádio.

Requisitos

Requisito Valor
Cabeçalho ksmedia.h (inclua Ksmedia.h)

Confira também

KSPROPERTY

KSPROPERTY_TUNER_STATUS

PROPSETID_TUNER