Condividi tramite


Interfaccia IAudioClient (audioclient.h)

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:

  1. Usando una delle tecniche descritte in Interfaccia IMMDevice, ottenere un riferimento all'interfaccia IMMDevice per un dispositivo endpoint audio.
  2. 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