KSPROPERTY_TUNER_STATUS_S estrutura (ksmedia.h)
A estrutura KSPROPERTY_TUNER_STATUS_S descreve o progresso de uma operação de ajuste para dispositivos de TV e de radioajuste, 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 de KSPROPERTY inicializada que descreve o conjunto de propriedades, a ID da propriedade e o tipo de solicitação.
CurrentFrequency
Especifica a frequência do ajuste atual. Esse valor está em hertz (Hz).
PLLOffset
Especifica o deslocamento de PLL (loop bloqueado por fase) em múltiplos da granularidade de ajuste. Isso será usado se a estratégia de ajuste for KS_TUNER_STRATEGY_PLL. Se a estratégia de ajuste não for KS_TUNER_STRATEGY_PLL, esse valor não terá nenhum 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 de ajuste for KS_TUNER_STRATEGY_SIGNAL_STRENGTH. Independentemente da estratégia de ajuste compatível com o minidriver, os valores válidos para este 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 deve ser definido como VERDADEIRO se o minidriver estiver atualmente ajustando para um canal. Caso contrário, se o minidriver não estiver atualmente ajustando para um novo canal, esse membro deverá ser definido como false.
Observações
Para obter mais informações sobre o plloffset e membros do SignalStrength, consulte de captura de TV baseada em PCI. Se o dispositivo de ajuste der suporte ao ajuste de rádio, consulte Dispositivos de Captura de Vídeo comde Ajustes de Rádio.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | ksmedia.h (inclua Ksmedia.h) |