Interfaccia IAudioClient (audioclient.h)

Articolo
11/20/2024

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 IMMDevice Interface, 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. A partire da Windows 10 Build 20348 i chiamanti possono passare un AUDIOCLIENT_ACTIVATION_PARAMS per configurare il IAudioClient per l'acquisizione di loopback con un filtro di processo.

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:

Eredità

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

Metodi

L'interfaccia IAudioClient dispone di 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 riempimento 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 dell'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.

Osservazioni

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.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [app desktop \| App UWP]
server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	audioclient.h

Vedere anche

interfacce audio principali

IMMDevice::Activate

WASAPI

Condividi tramite