KSPROPERTY_TUNER_SCAN_STATUS
La propriété KSPROPERTY_TUNER_SCAN_STATUS décrit la status d’une opération d’analyse. Cette propriété peut être implémentée éventuellement.
Tableau récapitulatif de l’utilisation
| Get | Set | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
Oui |
Non |
Épingle |
KSPROPERTY_TUNER_SCAN_STATUS_S |
La valeur de propriété (données d’opération) est une structure KSPROPERTY_TUNER_SCAN_STATUS_S qui spécifie la status d’une opération d’analyse.
Remarques
Le module KsTvTune.ax peut appeler la propriété KSPROPERTY_TUNER_SCAN_STATUS du pilote à tout moment. Toutefois, KsTvTune.ax appelle généralement KSPROPERTY_TUNER_SCAN_STATUS après avoir appelé l’événement KSEVENT_TUNER_INITIATE_SCAN pour configurer une opération d’analyse et pour configurer la notification à la fin de l’analyse. KsTvTune.ax attend que la notification de fin de l’analyse se produise. Dans le pire des cas, KsTvTune.ax attend la durée spécifiée dans le membre SettlingTime de la structure TUNER_ANALOG_CAPS_S . Le pilote doit avoir retourné une TUNER_ANALOG_CAPS_S remplie d’un appel à sa propriété KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS avec la valeur ANALOG_TV_NETWORK_TYPE définie dans le membre NetworkType de la structure KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S . Toutefois, le tuner doit généralement déterminer la status du signal plus rapidement que la durée spécifiée dans SettlingTime et doit ensuite informer KsTvTune.ax que l’analyse s’est terminée en signalant l’événement.
Le pilote retourne l’analyse status uniquement si l’appareil de paramétrage prend en charge l’analyse assistée par le matériel. Le pilote indique une telle prise en charge en définissant le membre fSupportsHardwareAssistedScanning de la structure KSPROPERTY_TUNER_SCAN_CAPS_S sur TRUE dans un appel à sa propriété KSPROPERTY_TUNER_SCAN_CAPS . Le pilote doit signaler un événement et retourner l’un des types de verrous suivants dans le membre LockStatus de la structure KSPROPERTY_TUNER_SCAN_STATUS_S :
Tuner_LockType_None si l’appareil de réglage n’a trouvé aucun signal.
Tuner_LockType_Locked si l’appareil de réglage est verrouillé sur la fréquence exacte.
Spécifications
Version |
Disponible dans Windows Vista et les versions ultérieures du système d’exploitation. |
En-tête |
Ksmedia.h (inclure Ksmedia.h) |
Voir aussi
KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS
KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS_S