Metodo IAudioClient::Start (audioclient.h)
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 |
|---|---|
|
Il flusso audio non è stato inizializzato correttamente. |
|
Il flusso audio non è stato arrestato al momento della chiamata Start . |
|
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. |
|
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. |
|
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 |