KSPROPERTY_STREAM_RATE

La proprietà KSPROPERTY_STREAM_RATE funziona insieme a KSPROPERTY_STREAM_RATECAPABILITY e viene usata per impostare la frequenza di un segmento dopo aver eseguito una query sulla funzionalità del pin.

Tabella riepilogo utilizzo

Get	Set	Destinazione	Tipo di descrittore delle proprietà	Tipo valore proprietà
Sì	Sì	Aggiungi (Blocca)	KSPROPERTY	KSRATE

Commenti

KSPROPERTY_STREAM_RATE deve essere implementato se un pin consente modifiche della frequenza o l'interfaccia tra pin toplogicamente correlati è diversa e genera un formato timestamp diverso da usare.

La proprietà è supportata dai pin che possono modificare la frequenza dei dati tramite modifiche di rimpling o timestamp in modo che una frequenza richiesta possa essere più vicina alla frequenza nominale di 1,0.

La lettura della proprietà restituisce la frequenza corrente e il segmento. L'impostazione della frequenza per un nuovo segmento sostituisce qualsiasi impostazione di frequenza corrente. In questo modo, arrestare una richiesta di inoltro rapido può essere eseguita richiedendo un'impostazione di frequenza pari a 1,0, che deve essere sempre accettata. Se la frequenza specificata non è recuperabile, il pin può rifiutare la richiesta anziché tentare un'impostazione più adatta.

L'impostazione della frequenza e la query usano la struttura KSRATE che specifica l'inizio della presentazione, la durata e la frequenza. Le modifiche della frequenza possono essere eseguite solo in pausa o in stato di esecuzione e vengono arrestate dopo la modifica a qualsiasi altro stato. La modifica della frequenza viene specificata dalla percentuale superiore o sotto la frequenza nominale 1,0 per cui il pin viene modificato e l'impostazione corrente viene restituita nello stesso formato.

Questa proprietà deve essere usata anche per tradurre l'interfaccia e le unità temporali specificate nella proprietà precedente e devono essere implementate nei filtri che modificano le interfacce tra pin, anche se le modifiche della frequenza non sono supportate. Ad esempio, un filtro che supporta KSINTERFACE_STANDARD_POSITION su un pin e viene convertito in KSINTERFACE_STANDARD_STREAMING in un altro pin correlato alla topologia potrebbe non supportare le modifiche della frequenza. Il filtro deve essere in grado di accettare la richiesta di modifica sul pin e su entrambe le interfacce e passare alla propria interfaccia e unità, anche se la frequenza sarebbe invariata.

Se il pin produce anche un orologio, una modifica della frequenza non deve modificare la pendenza del tempo fisico, perché qualsiasi client che usa il clock per la corrispondenza della frequenza prevede che la pendenza sia come se l'hardware sottostante fosse in esecuzione a una velocità nominale di 1,0. Ciò significa che un pin che non può garantire che la pendenza del orologio fisico rimanga coerente senza una deriva significativa non può accettare richieste di regolazione della frequenza.

Requisiti

Intestazione

Ks.h (includono Ks.h)

Vedi anche

KSPROPERTY_STREAM_RATECAPABILITY

KSRATE