KSPROPERTY_TUNER_SCAN_STATUS
La proprietà KSPROPERTY_TUNER_SCAN_STATUS descrive lo stato di un'operazione di analisi. Questa proprietà può essere implementata facoltativamente.
Tabella riepilogo utilizzo
| Get | Set | Destinazione | Tipo di descrittore di proprietà | Tipo valore proprietà |
|---|---|---|---|---|
Sì |
No |
Aggiungi (Blocca) |
KSPROPERTY_TUNER_SCAN_STATUS_S |
Il valore della proprietà (dati dell'operazione) è una struttura KSPROPERTY_TUNER_SCAN_STATUS_S che specifica lo stato di un'operazione di analisi.
Commenti
Il modulo KsTvTune.ax può chiamare la proprietà KSPROPERTY_TUNER_SCAN_STATUS del driver in qualsiasi momento. Tuttavia, KsTvTune.ax in genere chiama KSPROPERTY_TUNER_SCAN_STATUS dopo aver chiamato l'evento KSEVENT_TUNER_INITIATE_SCAN per configurare un'operazione di analisi e configurare la notifica per il completamento dell'analisi. KsTvTune.ax attende quindi che venga eseguita la notifica di completamento dell'analisi. Come scenario peggiore, KsTvTune.ax attende il periodo di tempo specificato nel membro SettlingTime della struttura TUNER_ANALOG_CAPS_S . Il driver deve aver restituito un TUNER_ANALOG_CAPS_S popolato da una chiamata alla relativa proprietà KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS con il valore ANALOG_TV_NETWORK_TYPE impostato nel membro NetworkType della struttura KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S . Tuttavia, il tuner deve in genere determinare lo stato del segnale più veloce della quantità di tempo specificata in SettlingTime e deve quindi notificare KsTvTune.ax che l'analisi è stata completata segnalando l'evento.
Il driver restituisce lo stato dell'analisi solo se il dispositivo di ottimizzazione supporta l'analisi assistita dall'hardware. Il driver indica tale supporto impostando il membro fSupportsHardwareAssistedScanning della struttura KSPROPERTY_TUNER_SCAN_CAPS_S su TRUE in una chiamata alla relativa proprietà KSPROPERTY_TUNER_SCAN_CAPS . Il driver deve segnalare un evento e restituire uno dei tipi di blocco seguenti nel membro LockStatus della struttura KSPROPERTY_TUNER_SCAN_STATUS_S :
Tuner_LockType_None se il dispositivo di ottimizzazione non riesce a trovare alcun segnale.
Tuner_LockType_Locked se il dispositivo di ottimizzazione è bloccato sulla frequenza esatta.
Requisiti
Versione |
Disponibile in Windows Vista e versioni successive del sistema operativo. |
Intestazione |
Ksmedia.h (include Ksmedia.h) |
Vedi anche
KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS
KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S