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à

No

Aggiungi (Blocca)

KSPROPERTY

KSAUDIO_POSITIONEX

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)

Vedere anche

KSAUDIO_POSITIONEX

KSPROPERTY