KSPROPERTY_TUNER_SCAN_STATUS

Artigo
06/15/2023

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