Share via

Metodo IAudioClient::Stop (audioclient.h)

  • Articolo

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
AUDCLNT_E_NOT_INITIALIZED
 Il client non è stato inizializzato correttamente.
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 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

Vedi anche

Interfaccia IAudioClient

IAudioClient::Initialize

IAudioClient::Reset

IAudioClient::Start