Método IAudioClient::Start (audioclient.h)
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 |
|---|---|
|
La secuencia de audio no se ha inicializado correctamente. |
|
La secuencia de audio no se detuvo en el momento de la llamada Start . |
|
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. |
|
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. |
|
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 |