KSPROPERTY_TUNER_SCAN_STATUS
A propriedade KSPROPERTY_TUNER_SCAN_STATUS descreve o status de uma operação de verificação. Essa propriedade pode ser implementada opcionalmente.
Tabela de Resumo de Uso
| Get | Set | Destino | Tipo de descritor de propriedade | Tipo de valor da propriedade |
|---|---|---|---|---|
Yes |
No |
Pin |
KSPROPERTY_TUNER_SCAN_STATUS_S |
O valor da propriedade (dados de operação) é uma estrutura KSPROPERTY_TUNER_SCAN_STATUS_S que especifica o status de uma operação de verificação.
Comentários
O módulo KsTvTune.ax pode chamar a propriedade KSPROPERTY_TUNER_SCAN_STATUS do driver a qualquer momento. No entanto, KsTvTune.ax normalmente chama KSPROPERTY_TUNER_SCAN_STATUS depois de chamar o evento KSEVENT_TUNER_INITIATE_SCAN para configurar uma operação de verificação e configurar a notificação para quando a verificação for concluída. KsTvTune.ax aguarda a notificação de conclusão da verificação ocorrer. Como o pior cenário, KsTvTune.ax aguarda a quantidade de tempo especificada no membro SettlingTime da estrutura TUNER_ANALOG_CAPS_S . O driver deve ter retornado um TUNER_ANALOG_CAPS_S preenchido de uma chamada para sua propriedade KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS com o valor ANALOG_TV_NETWORK_TYPE definido no membro NetworkType da estrutura KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S . No entanto, o sintonizador normalmente deve determinar o status do sinal mais rápido do que o tempo especificado em SettlingTime e, em seguida, deve notificar KsTvTune.ax que a verificação foi concluída sinalizando o evento.
O driver retornará status de verificação somente se o dispositivo de ajuste der 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 . O driver deve sinalizar um evento e retornar um dos seguintes tipos de bloqueio no membro LockStatus da estrutura KSPROPERTY_TUNER_SCAN_STATUS_S :
Tuner_LockType_None se o dispositivo de ajuste não puder encontrar nenhum sinal.
Tuner_LockType_Locked se o dispositivo de ajuste estiver bloqueado na frequência exata.
Requisitos
Versão |
Disponível no Windows Vista e versões posteriores do sistema operacional. |
parâmetro |
Ksmedia.h (inclua Ksmedia.h) |
Confira também
KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS
KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S