KSPROPERTY_STREAM_RATE
La propriété KSPROPERTY_STREAM_RATE fonctionne conjointement avec KSPROPERTY_STREAM_RATECAPABILITY et est utilisée pour définir la vitesse d’un segment après avoir interrogé la fonctionnalité de l’épingle.
Tableau récapitulatif de l’utilisation
| Get | Set | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
Oui |
Oui |
Épingle |
Remarques
KSPROPERTY_STREAM_RATE doit être implémenté si une broche autorise des changements de taux, ou si l’interface entre les broches topologiquement liées est différente et entraîne l’utilisation d’un format d’horodatage différent.
La propriété est prise en charge par des broches qui peuvent modifier le taux de données par le biais d’un rééchantillonnage ou de modifications d’horodatage afin qu’un taux demandé puisse être plus proche du taux nominal de 1,0.
La lecture de la propriété retourne le taux et le segment actuels. La définition du taux pour un nouveau segment remplace tout paramètre de débit actuel. De cette façon, l’arrêt d’une demande d’avance rapide peut être effectué en demandant un paramètre de taux de 1.0, qui doit toujours être accepté. Si le taux spécifié n’est pas accessible, l’épingle peut rejeter la demande au lieu de tenter d’obtenir le paramètre le mieux adapté.
Le paramètre de débit et la requête utilisent la structure KSRATE qui spécifie le début, la durée et la vitesse de la présentation. Les modifications de taux ne peuvent être effectuées qu’en pause ou en état d’exécution et sont arrêtées après le passage à un autre état. Le changement de taux est spécifié par le pourcentage supérieur ou inférieur au taux nominal de 1,0 pour lequel la broche doit ajuster et le paramètre actuel est retourné dans le même format.
Cette propriété doit également être utilisée pour traduire l’interface et les unités de temps spécifiées dans la propriété précédente et doit être implémentée sur les filtres qui modifient les interfaces entre les broches, même si les modifications de débit ne sont pas prises en charge. Par exemple, un filtre qui prend en charge KSINTERFACE_STANDARD_POSITION sur une broche et se traduit par KSINTERFACE_STANDARD_STREAMING sur une autre broche liée par la topologie peut ne pas prendre en charge les modifications de taux. Le filtre doit être en mesure d’accepter la demande de modification sur l’une ou l’autre des broches et de l’une ou l’autre interface, et de passer à sa propre interface et à ses propres unités, bien que le taux soit inchangé.
Si la broche produit également une horloge, un changement de taux ne doit pas modifier la pente de l’heure physique, car tout client utilisant l’horloge pour la correspondance de taux s’attend à ce que la pente soit comme si le matériel sous-jacent s’exécutait à un taux nominal de 1,0. Cela signifie qu’une broche qui ne peut pas garantir que la pente de l’horloge physique reste cohérente sans dérive significative ne peut pas accepter les demandes d’ajustement du taux.
Configuration requise
En-tête |
Ks.h (inclure Ks.h) |