Metodo IAudioClient::Stop (audioclient.h)
Il metodo Stop arresta il flusso audio.
Sintassi
HRESULT Stop();
Valore restituito
Se il metodo ha esito positivo e arresta il flusso, restituisce S_OK. Se il metodo ha esito positivo e il flusso è già stato arrestato, il metodo restituisce S_FALSE. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.
Codice restituito | Descrizione |
---|---|
|
Il client non è stato inizializzato correttamente. |
|
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 non inizializza il flusso audio chiamando correttamente il metodo IAudioClient::Initialize .
Stop è un metodo di controllo che arresta un flusso audio in esecuzione. Questo metodo impedisce lo streaming dei dati tramite la connessione del client con il motore audio. L'arresto del flusso blocca l'orologio audio del flusso nella posizione corrente del flusso. Una chiamata successiva a IAudioClient::Start fa sì che il flusso riprenda l'esecuzione da tale posizione. Se necessario, il client può chiamare il metodo IAudioClient::Reset per reimpostare la posizione mentre il flusso viene arrestato.
Per esempi di codice che chiamano il metodo Stop , 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 |