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 ajuste da enumeração KSPROPERTY_TUNER_MODES que é definida em Ksmedia.h.
| Bandeira | 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 | O sintonizador está atualmente 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 as transmissões do Comitê avançado de sistemas de televisão (TV digital para os Estados Unidos). Essa configuração também pode ser usada por sistemas DVB-T e DVB-C. |
StandardsSupported
Se o Mode membro 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 frequência mais baixa, em Hz, à qual o sintonizador dá suporte.
MaxFrequency
A frequência mais alta, em Hz, à qual 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 etapa em todo o intervalo de frequência que se baseia 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 ajuste 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 status de bloqueio no sinal por meio de uma chamada para a propriedade KSPROPERTY_TUNER_SCAN_STATUS do driver. Se o driver relatar o status de bloqueio como Tuner_LockType_Within_Scan_Sensing_Range no LockStatus membro da estrutura de 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 ajuste usa para determinar a frequência real de um sinal. O filtro de ajuste 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 fSupportsHardwareAssistedScanning membro da estrutura KSPROPERTY_TUNER_SCAN_CAPS_S para TRUE em uma chamada para sua propriedade KSPROPERTY_TUNER_SCAN_CAPS. Quando o filtro de ajuste inicia uma verificação, ele inicialmente investiga o driver em incrementos dentro do intervalo que o membro ScanSensingRange especifica até que o driver retorne Tuner_LockType_Within_Scan_Sensing_Range. Em seguida, o filtro de ajuste alterna para as etapas de FineTuneSensingRange até que o driver reporte um bloqueio completo.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores do sistema operacional. |
| cabeçalho | ksmedia.h (inclua Ksmedia.h) |