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