KSPROPERTY_AUDIO_POSITIONEX
La proprietà KSPROPERTY_AUDIO_POSITIONEX fornisce al chiamante la posizione del flusso e le informazioni sul timestamp associate per un driver audio basato su kernel streaming (KS).
Tabella riepilogo utilizzo
Recupero | Set | Destinazione | Tipo di descrittore di proprietà | Tipo valore proprietà |
---|---|---|---|---|
Sì |
No |
Aggiungi (Blocca) |
Il valore della proprietà (dati dell'operazione) è una struttura di tipo KSAUDIO_POSITIONEX che riceve le informazioni sulla posizione dal gestore della proprietà. Le informazioni sulla posizione specificate dalla struttura KSAUDIO_POSITIONEX sono le informazioni sulla posizione per il pin selezionato dal chiamante.
Valore restituito
La richiesta di proprietà KSPROPERTY_AUDIO_POSITIONEX restituisce S_OK se la chiamata ha avuto esito positivo. In caso contrario, restituisce il codice di errore HRESULT appropriato.
Commenti
In genere, le applicazioni audio devono monitorare la posizione corrente di un flusso audio. Questa posizione viene specificata come offset di byte dall'inizio del flusso. Esistono due possibili interpretazioni delle informazioni sulla posizione del flusso:
Nel caso di un flusso di rendering, la posizione del flusso è l'offset di byte del fotogramma audio attualmente riprodotto tramite i convertitori digitali-analogici (DAC).
Nel caso di un flusso di acquisizione, la posizione del flusso è l'offset di byte del fotogramma audio attualmente registrato tramite i convertitori analogici-digitali (ADC).
Un driver che supporta la proprietà KSPROPERTY_AUDIO_POSITIONEX genera una finestra timestamp per il valore della posizione del flusso. La finestra timestamp è l'intervallo tra il timestamp campionato prima che venga determinata la posizione del flusso e il timestamp acquisito dopo la determinazione della posizione del flusso. Il chiamante determina quindi se può usare la finestra timestamp.
Requisiti
Versione |
Disponibile in Windows Vista e versioni successive di Windows. |
Intestazione |
Ksmedia.h (include Ksmedia.h) |