Metodo IAudioClient::GetStreamLatency (audioclient.h)
Il metodo GetStreamLatency recupera la latenza massima per il flusso corrente e può essere chiamato qualsiasi volta dopo l'inizializzazione del flusso.
Sintassi
HRESULT GetStreamLatency(
[out] REFERENCE_TIME *phnsLatency
);
Parametri
[out] phnsLatency
Puntatore a una variabile REFERENCE_TIME in cui il metodo scrive un valore di tempo che rappresenta la latenza. Il tempo viene espresso in unità da 100 nanosecondi. Per altre informazioni su REFERENCE_TIME, vedere la documentazione di Windows SDK.
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il flusso audio non è stato inizializzato correttamente. |
|
Il dispositivo endpoint audio è stato scollegato o l'hardware audio o le risorse hardware associate sono state riconfigurate, disabilitate, rimosse o altrimenti non disponibili per l'uso. |
|
Il servizio audio Di Windows non è in esecuzione. |
|
La phnsLatency del parametro è NULL. |
Commenti
Questo metodo richiede l'inizializzazione precedente dell'interfaccia IAudioClient . Tutte le chiamate a questo metodo avranno esito negativo con l'errore AUDCLNT_E_NOT_INITIALIZED finché il client inizializza il flusso audio chiamando correttamente il metodo IAudioClient::Initialize .
Questo metodo recupera la latenza massima per il flusso corrente. Il valore non verrà modificato per la durata dell'oggetto IAudioClient .
I client di rendering possono usare questo valore di latenza per calcolare la quantità minima di dati che possono scrivere durante qualsiasi passaggio di elaborazione singolo. Per scrivere meno di questo minimo è quello di introdurre glitch nel flusso audio. Per altre informazioni, vedere IAudioRenderClient::GetBuffer.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2008 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | audioclient.h |