Compartir a través de

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

  • Artículo

El método Start inicia la secuencia de audio.

Sintaxis

HRESULT Start();

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. 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
 La secuencia de audio no se ha inicializado correctamente.
AUDCLNT_E_NOT_STOPPED
 La secuencia de audio no se detuvo en el momento de la llamada Start .
AUDCLNT_E_EVENTHANDLE_NOT_SET
 La secuencia de audio está configurada para usar el almacenamiento en búfer controlado por eventos, pero el autor de la llamada no ha llamado a IAudioClient::SetEventHandle para establecer el identificador de evento en la secuencia.
AUDCLNT_E_DEVICE_INVALIDATED
 El dispositivo de punto de conexión de audio se ha desconectado o el hardware de audio o los recursos de hardware asociados se han reconfigurado, deshabilitado, quitado o dejado de estar disponible para su uso.
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 .

Start es un método de control al que el cliente llama para iniciar la secuencia de audio. Al iniciar la secuencia, el objeto IAudioClient comienza a transmitir datos entre el búfer de puntos de conexión y el motor de audio. También hace que el reloj de audio de la secuencia reanude el recuento de su posición actual.

La primera vez que se llama a este método después de la inicialización de la secuencia, el contador de posición de flujo del objeto IAudioClient comienza en 0. De lo contrario, el reloj se reanuda desde su posición en el momento en que la secuencia se detuvo por última vez. Al restablecer la secuencia, la posición de la secuencia vuelve a ser 0.

Para evitar problemas de inicio con secuencias de representación, los clientes no deben llamar a Start hasta que el motor de audio se haya cargado inicialmente con datos llamando a los métodos IAudioRenderClient::GetBuffer e IAudioRenderClient::ReleaseBuffer en la interfaz de representación.

Para obtener ejemplos de código que llaman al método Start , 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

IAudioRenderClient::GetBuffer

IAudioRenderClient::ReleaseBuffer