Método IAudioClient::Stop (audioclient.h)

  • Artículo

El método Stop detiene la secuencia de audio.

Sintaxis

HRESULT Stop();

Valor devuelto

Si el método se ejecuta correctamente y detiene la secuencia, devuelve S_OK. Si el método se realiza correctamente y la secuencia ya se ha detenido, el método devuelve S_FALSE. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
AUDCLNT_E_NOT_INITIALIZED
 El cliente no se ha inicializado correctamente.
AUDCLNT_E_SERVICE_NOT_RUNNING
 El servicio de audio de Windows no se está ejecutando.

Comentarios

Este método requiere inicialización previa de la interfaz IAudioClient . Todas las llamadas a este método producirán el error AUDCLNT_E_NOT_INITIALIZED hasta que el cliente inicialice la secuencia de audio llamando correctamente al método IAudioClient::Initialize .

Stop es un método de control que detiene una secuencia de audio en ejecución. Este método detiene el streaming de datos a través de la conexión del cliente con el motor de audio. Detener la secuencia bloquea el reloj de audio de la secuencia en su posición actual de la secuencia. Una llamada posterior a IAudioClient::Start hace que la secuencia se reanude la ejecución desde esa posición. Si es necesario, el cliente puede llamar al método IAudioClient::Reset para restablecer la posición mientras se detiene la secuencia.

Para obtener ejemplos de código que llaman al método Stop , consulte los temas siguientes:

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado audioclient.h

Consulte también

IAudioClient (interfaz)

IAudioClient::Initialize

IAudioClient::Reset

IAudioClient::Start