estrutura TUNER_ANALOG_CAPS_S (ksmedia.h)
A estrutura TUNER_ANALOG_CAPS_S descreve os recursos de verificação de hardware de um dispositivo de ajuste que dá suporte a uma rede de transmissão analógica.
Sintaxe
typedef struct {
ULONG Mode;
ULONG StandardsSupported;
ULONG MinFrequency;
ULONG MaxFrequency;
ULONG TuningGranularity;
ULONG SettlingTime;
ULONG ScanSensingRange;
ULONG FineTuneSensingRange;
} TUNER_ANALOG_CAPS_S, *PTUNER_ANALOG_CAPS_S;
Membros
Mode
O modo de ajuste atual, que pode ser representado por um dos seguintes sinalizadores de modo de sintonizador da enumeração KSPROPERTY_TUNER_MODES definida em Ksmedia.h.
| Sinalizador | Significado |
|---|---|
| KSPROPERTY_TUNER_MODE_TV | O sintonizador está atualmente ajustando canais de transmissão ou tv a cabo. |
| KSPROPERTY_TUNER_MODE_FM_RADIO | No momento, o sintonizador está ajustando canais de rádio FM. |
| KSPROPERTY_TUNER_MODE_AM_RADIO | No momento, o sintonizador está ajustando canais de rádio AM. |
| KSPROPERTY_TUNER_MODE_DSS | No momento, o sintonizador está ajustando canais DSS. |
| KSPROPERTY_TUNER_MODE_ATSC | O sintonizador é capaz de ajustar transmissões avançadas do Comitê de Sistemas de Televisão (TV digital para o Estados Unidos). Essa configuração também pode ser usada pelos sistemas DVB-T e DVB-C. |
StandardsSupported
Se o membro Mode estiver definido como KSPROPERTY_TUNER_MODE_TV ou KSPROPERTY_TUNER_MODE_DSS, um OR bit a bit de valores da enumeração KS_AnalogVideoStandard que indica os padrões de vídeo analógicos aos quais o sintonizador dá suporte. Caso contrário, esse membro será ignorado.
MinFrequency
A menor frequência, em Hz, que o sintonizador dá suporte.
MaxFrequency
A frequência mais alta, em Hz, que o sintonizador dá suporte.
TuningGranularity
O menor tamanho de etapa possível, em Hz, entre duas configurações da frequência de ajuste.
SettlingTime
O tempo, em milissegundos, para que uma nova configuração de frequência se torne estável.
KsTvTune.ax usa o valor em SettlingTime para avaliar o tempo total que seu algoritmo de verificação pode levar para que ele possa determinar o tempo de espera. O valor em SettlingTime juntamente com o número de incrementos de etapas em todo o intervalo de frequência baseado no intervalo de detecção deve fornecer uma estimativa do tempo total necessário para o algoritmo de verificação.
ScanSensingRange
O intervalo que o dispositivo de ajuste fornece e que o filtro de sintonizador usa para determinar a presença de um sinal. Esse intervalo representa os tamanhos de etapa maiores que um algoritmo de pesquisa de sinal pode usar para avançar pelo intervalo de frequências a serem pesquisadas. O driver pode relatar a frequência de bloqueio real de um sinal e o bloqueio status no sinal por meio de uma chamada para a propriedade KSPROPERTY_TUNER_SCAN_STATUS do driver. Se o driver relatar o bloqueio status como Tuner_LockType_Within_Scan_Sensing_Range no membro LockStatus da estrutura KSPROPERTY_TUNER_SCAN_STATUS_S, o tamanho da etapa de incremento mudará para o valor menor em FineTuneSensingRange até que a frequência de bloqueio real seja determinada.
FineTuneSensingRange
O intervalo que o dispositivo de ajuste fornece e que o filtro de sintonizador usa para determinar a frequência real de um sinal. O filtro de sintonizador usa esse intervalo de detecção de ajuste fino somente quando o hardware do sintonizador subjacente não pode dar suporte à verificação assistida por hardware. O driver indica esse suporte definindo o membro fSupportsHardwareAssistedScanning da estrutura KSPROPERTY_TUNER_SCAN_CAPS_S como TRUE em uma chamada para sua propriedade KSPROPERTY_TUNER_SCAN_CAPS . Quando o filtro de sintonizador inicia uma verificação, ele investiga inicialmente o driver em incrementos dentro do intervalo especificado pelo membro ScanSensingRange até que o driver retorne Tuner_LockType_Within_Scan_Sensing_Range. Em seguida, o filtro de sintonizador alterna para as etapas de FineTuneSensingRange até que o driver reporte um bloqueio completo.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows Vista e versões posteriores do sistema operacional. |
| Cabeçalho | ksmedia.h (inclua Ksmedia.h) |