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
AUDCLNT_E_NOT_INITIALIZED
Il flusso audio non è stato inizializzato correttamente.
AUDCLNT_E_DEVICE_INVALIDATED
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.
AUDCLNT_E_SERVICE_NOT_RUNNING
Il servizio audio Di Windows non è in esecuzione.
E_POINTER
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

Vedi anche

Interfaccia IAudioClient

IAudioClient::Initialize

IAudioRenderClient::GetBuffer