KSPROPERTY_STREAM_RATE
A propriedade KSPROPERTY_STREAM_RATE funciona em conjunto com KSPROPERTY_STREAM_RATECAPABILITY e é usada para definir a taxa de um segmento após consultar a funcionalidade do pino.
Tabela de Resumo de Uso
| Get | Set | Destino | Tipo de descritor de propriedade | Tipo de valor da propriedade |
|---|---|---|---|---|
Yes |
Yes |
Pin |
Comentários
KSPROPERTY_STREAM_RATE deverá ser implementado se um pin permitir alterações de taxa ou a interface entre pinos relacionados topologicamente for diferente e resultar em um formato de carimbo de data/hora diferente sendo usado.
A propriedade tem suporte de pinos que podem modificar a taxa de dados por meio de alterações de resampling ou carimbo de data/hora para que uma taxa solicitada possa estar mais próxima da taxa nominal de 1,0.
A leitura da propriedade retorna a taxa e o segmento atuais. Definir a taxa de um novo segmento substitui qualquer configuração de taxa atual. Dessa maneira, a interrupção de uma solicitação de avanço rápido pode ser feita solicitando uma configuração de taxa de 1,0, que sempre deve ser aceita. Se a taxa especificada não for obtida, o pino poderá rejeitar a solicitação em vez de tentar uma configuração de melhor ajuste.
A configuração de taxa e a consulta usam a estrutura KSRATE que especifica o início, a duração e a taxa da apresentação. As alterações de taxa só podem ser executadas em estado de pausa ou de execução e são interrompidas após a alteração para qualquer outro estado. A alteração de taxa é especificada pela porcentagem acima ou abaixo da taxa nominal de 1,0 para a qual o pino deve ser ajustado e a configuração atual é retornada no mesmo formato.
Essa propriedade também deve ser usada para traduzir a interface e as unidades de tempo especificadas na propriedade anterior e deve ser implementada em filtros que alteram interfaces entre pinos, mesmo que não haja suporte para alterações de taxa. Por exemplo, um filtro que dá suporte a KSINTERFACE_STANDARD_POSITION em um pino e é convertido em KSINTERFACE_STANDARD_STREAMING em outro pino relacionado pela topologia pode não dar suporte a alterações de taxa. O filtro deve ser capaz de fazer a solicitação de alteração em um dos pinos e em qualquer interface e alterar para sua própria interface e unidades, embora a taxa não seja alterada.
Se o pino também produzir um relógio, uma alteração de taxa não deverá alterar a inclinação do tempo físico, pois qualquer cliente que usa o relógio para correspondência de taxa espera que a inclinação seja como se o hardware subjacente estivesse em execução a uma taxa nominal de 1,0. Isso significa que um pino que não pode garantir que a inclinação do relógio físico permaneça consistente sem um descompasso significativo não pode aceitar solicitações de ajuste de taxa.
Requisitos
parâmetro |
Ks.h (inclua Ks.h) |