Interfaccia IAudioClient (audioclient.h)

Articolo
08/22/2023

L'interfaccia IAudioClient consente a un client di creare e inizializzare un flusso audio tra un'applicazione audio e il motore audio (per un flusso in modalità condivisa) o il buffer hardware di un dispositivo endpoint audio (per un flusso in modalità esclusiva). Un client ottiene un riferimento a un'interfaccia IAudioClient per un dispositivo endpoint audio seguendo questa procedura:

Usando una delle tecniche descritte in Interfaccia IMMDevice, ottenere un riferimento all'interfaccia IMMDevice per un dispositivo endpoint audio.
Chiamare il metodo IMMDevice::Activate con il parametro iid impostato su REFIID IID_IAudioClient.

Il thread dell'applicazione che usa questa interfaccia deve essere inizializzato per COM. Per altre informazioni sull'inizializzazione COM, vedere la descrizione della funzione CoInitializeEx nella documentazione di Windows SDK.

Per esempi di codice che usano l'interfaccia IAudioClient , vedere gli argomenti seguenti:

Ereditarietà

L'interfaccia IAudioClient eredita dall'interfaccia IUnknown . IAudioClient include anche questi tipi di membri:

Metodi

L'interfaccia IAudioClient include questi metodi.


IAudioClient::GetBufferSize Il metodo GetBufferSize recupera le dimensioni (capacità massima) del buffer dell'endpoint.
IAudioClient::GetCurrentPadding Il metodo GetCurrentPadding recupera il numero di fotogrammi di spaziatura interna nel buffer dell'endpoint.
IAudioClient::GetDevicePeriod Il metodo GetDevicePeriod recupera la lunghezza dell'intervallo periodico separando i passaggi di elaborazione successivi dal motore audio sui dati nel buffer dell'endpoint.
IAudioClient::GetMixFormat Il metodo GetMixFormat recupera il formato di flusso utilizzato dal motore audio per l'elaborazione interna dei flussi in modalità condivisa.
IAudioClient::GetService Il metodo GetService accede a servizi aggiuntivi dall'oggetto client audio.
IAudioClient::GetStreamLatency Il metodo GetStreamLatency recupera la latenza massima per il flusso corrente e può essere chiamata in qualsiasi momento dopo l'inizializzazione del flusso.
IAudioClient::Initialize Il metodo Initialize inizializza il flusso audio.
IAudioClient::IsFormatSupported Il metodo IsFormatSupported indica se il dispositivo endpoint audio supporta un formato di flusso specifico.
IAudioClient::Reset Il metodo Reset reimposta il flusso audio.
IAudioClient::SetEventHandle Il metodo SetEventHandle imposta l'handle di evento che il sistema segnala quando un buffer audio è pronto per l'elaborazione da parte del client.
IAudioClient::Start Il metodo Start avvia il flusso audio.
IAudioClient::Stop Il metodo Stop arresta il flusso audio.

Commenti

Nota In Windows 8, il primo uso di IAudioClient per accedere al dispositivo audio deve trovarsi nel thread STA. Le chiamate da un thread MTA possono comportare un comportamento non definito.

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

Interfacce audio di base

IMMDevice::Activate

WASAPI