Share via

Metodo IAudioClient::Start (audioclient.h)

  • Articolo

Il metodo Start avvia il flusso audio.

Sintassi

HRESULT Start();

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_NOT_STOPPED
 Il flusso audio non è stato arrestato al momento della chiamata Start .
AUDCLNT_E_EVENTHANDLE_NOT_SET
 Il flusso audio è configurato per l'uso del buffer basato su eventi, ma il chiamante non ha chiamato IAudioClient::SetEventHandle per impostare l'handle eventi nel flusso.
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.

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 .

Start è un metodo di controllo che il client chiama per avviare il flusso audio. L'avvio del flusso causa l'avvio dell'oggetto IAudioClient per avviare lo streaming dei dati tra il buffer dell'endpoint e il motore audio. Determina inoltre che l'orologio audio del flusso riprende il conteggio dalla sua posizione corrente.

La prima volta che questo metodo viene chiamato dopo l'inizializzazione del flusso, il contatore della posizione di flusso dell'oggetto IAudioClient inizia a 0. In caso contrario, l'orologio riprende dalla sua posizione al momento dell'ultimo arresto del flusso. La reimpostazione del flusso forza la posizione del flusso fino a 0.

Per evitare errori di avvio con flussi di rendering, i client non devono chiamare Start finché il motore audio non è stato inizialmente caricato con i dati chiamando i metodi IAudioRenderClient::GetBuffer e IAudioRenderClient::ReleaseBuffer nell'interfaccia di rendering.

Per esempi di codice che chiamano il metodo Start , vedere gli argomenti seguenti:

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

IAudioRenderClient::ReleaseBuffer