KSPROPERTY_STREAM_RATECAPABILITY
La proprietà KSPROPERTY_STREAM_RATECAPABILITY consente a un gestore grafico di eseguire query su tutti i punti di connessione coinvolti nel flusso di un determinato flusso (ottenuto tramite KSPROPERTY_PIN_DATAROUTING) per la loro capacità di regolare una frequenza richiesta alla frequenza nominale.
Tabella riepilogo utilizzo
| Get | Set | Destinazione | Tipo di descrittore delle proprietà | Tipo valore proprietà |
|---|---|---|---|---|
Sì |
No |
Aggiungi (Blocca) |
Commenti
KSPROPERTY_STREAM_RATECAPABILITY devono essere implementati se un pin consente modifiche della frequenza o l'interfaccia tra pin toplogicamente correlati è diversa e comporta l'uso di un formato timestamp diverso. La proprietà può essere usata anche per tradurre i formati di timestamp in generale, ad esempio ignorare le richieste di riduzione.
La proprietà è supportata dai pin che modificano la frequenza dei dati tramite il rimpling o le modifiche del timestamp. Tutte le modifiche della frequenza comportano la richiesta di una tariffa e la determinazione della quantità di pin specifica che può correggere tale tasso per ottenere la tariffa nominale 1,0. Ad esempio, un pin che richiede una frequenza di riproduzione video di 2,0 implica una richiesta di rendering a due volte la frequenza nominale del clip video; una richiesta di frequenza pari a 0,5 implica un rendering a mezza velocità.
La richiesta di frequenza contiene sia l'ora di inizio della presentazione che la durata per tale richiesta di frequenza. Ciò consente di applicare vincoli a parti specifiche di un flusso di dati da tenere in considerazione. L'ora di presentazione, la coppia numeratore/denominatore e le unità di durata vengono espresse in termini di Interfaccia specificata nella struttura. Se non viene usata un'interfaccia standard, le query di modifica della frequenza iniziale non possono essere inviate a un pin.
Un pin deve essere in grado di accettare gli identificatori di interfaccia usati da qualsiasi pin con topologia simile. Deve anche tradurre l'identificatore dell'interfaccia e le unità temporali in valori corrispondenti. In questo modo, un client può attraversare un grafico da un punto di interfaccia noto e avere unità tradotte da punti di connessione in ogni passaggio del modo.
È importante supportare questa proprietà se le modifiche dell'interfaccia vengono apportate anche se non è possibile apportare modifiche alla frequenza, in modo che le unità di interfaccia e ora possano essere modificate quando vengono apportate query. Il risultato non modifica la frequenza restituita, ma cambierà l'interfaccia, PresentationStart e Duration.
Le richieste di funzionalità di frequenza possono essere eseguite solo in Pausa o Esegui stato e diventano non valide dopo la modifica a qualsiasi altro stato. Le query in cui la frequenza è inizialmente 1.0 deve sempre avere esito positivo perché in genere sono solo richieste per tradurre i formati di timestamp.
Requisiti
Intestazione |
Ks.h (includono Ks.h) |