KSPROPERTY_STREAM_PRESENTATIONTIME

La proprietà KSPROPERTY_STREAM_PRESENTATIONTIME viene utilizzata per recuperare e impostare l'ora di presentazione corrente di un pin di filtro.

Tabella riepilogo utilizzo

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

Commenti

KSPROPERTY_STREAM_PRESENTATIONTIME è una proprietà facoltativa che deve essere implementata se un pin mantiene le informazioni posizionali o usa interfacce diverse con formati timestamp diversi su pin correlati a topologia. Pertanto, sarebbe necessario che i timestamp tradotti come ora di presentazione di ricerca si verifichino.

L'ora di presentazione del pin del filtro viene specificata come struttura KSTIME la cui interpretazione dipende dall'interfaccia utilizzata. Per l'interfaccia di streaming standard, il tempo viene specificato in incrementi di 100 nanosecondi (a meno che il numeratore e il denominatore non specifichino diversamente) che rappresenta la posizione di presentazione del flusso in cui il filtro sta attualmente elaborando o sta cercando di elaborare. Se si tratta di un filtro di rendering, questa posizione rappresenta i dati di cui è in corso il rendering. Queste informazioni sul posizionamento vengono sincronizzate con l'ora di presentazione dell'orologio master. L'ora di presentazione inizia in genere a zero e può rappresentare un offset temporale nei dati del file. Il numeratore e il denominatore possono essere usati per specificare l'allineamento del blocco applicato dall'interfaccia.

Questa proprietà viene usata anche durante la conversione di valori posizionali durante la propagazione di una richiesta di ricerca. Il valore posizionale di ricerca su un pin viene convertito all'interno del filtro in fase di presentazione su pin correlati in topologia. Un client imposta questa proprietà con una nuova posizione del flusso per la ricerca. Questa operazione viene in genere chiamata dal proxy quando è necessaria una ricerca dopo l'annullamento dell'I/O in sospeso e la reimpostazione dello stato del dispositivo. Se non è stata eseguita una reimpostazione, il filtro potrebbe dover annullare e reimpostare automaticamente in modo appropriato. La proprietà viene passata a un KSTIME contenente la nuova posizione del flusso in unità coerenti con l'interfaccia utilizzata nella connessione.

Dopo che un client(ad esempio, un proxy DirectShow) scrive una richiesta di ricerca in una connessione, quindi esegue una query sulle altre connessioni correlate in modo topologico per un'ora di presentazione. Tutte le altre connessioni che eseguono una richiesta di lettura riuscita eseguono il proxy passano la posizione del risultato all'altra estremità della connessione. In questo modo, le posizioni di ricerca vengono propagate (ad esempio, in tutto il grafico DirectShow) senza dover conoscere il formato dell'unità diversa dal formato di unità iniziale passato da un client. Le traduzioni vengono eseguite all'interno del filtro man mano che le informazioni posizionali vengono propagate attraverso la topologia all'interno di un filtro. Questo metodo di verifica viene usato perché i metodi di comunicazione possono essere limitati tra vari filtri in un grafico a seconda delle interfacce usate. Quando si imposta una nuova posizione di ricerca, la coppia numeratore/denominatore deve essere accettabile per il pin.

Requisiti

Intestazione

Ks.h (include Ks.h)

Vedi anche

KSTIME

KSPROPERTY