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

  • Article

La méthode Start démarre le flux audio.

Syntaxe

HRESULT Start();

Valeur de retour

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour Description
AUDCLNT_E_NOT_INITIALIZED
 Le flux audio n’a pas été initialisé avec succès.
AUDCLNT_E_NOT_STOPPED
 Le flux audio n’a pas été arrêté au moment de l’appel de démarrage .
AUDCLNT_E_EVENTHANDLE_NOT_SET
 Le flux audio est configuré pour utiliser la mise en mémoire tampon pilotée par les événements, mais l’appelant n’a pas appelé IAudioClient ::SetEventHandle pour définir le handle d’événement sur le flux.
AUDCLNT_E_DEVICE_INVALIDATED
 Le périphérique de point de terminaison audio a été débranché, ou le matériel audio ou les ressources matérielles associées ont été reconfigurés, désactivés, supprimés ou autrement indisponibles.
AUDCLNT_E_SERVICE_NOT_RUNNING
 Le service audio Windows n’est pas en cours d’exécution.

Remarques

Cette méthode nécessite une initialisation préalable de l’interface IAudioClient . Tous les appels à cette méthode échouent avec l’erreur AUDCLNT_E_NOT_INITIALIZED jusqu’à ce que le client initialise le flux audio en appelant correctement la méthode IAudioClient ::Initialize .

Start est une méthode de contrôle que le client appelle pour démarrer le flux audio. Le démarrage du flux entraîne le début du streaming de données par l’objet IAudioClient entre la mémoire tampon du point de terminaison et le moteur audio. Cela entraîne également la reprise du comptage de l’horloge audio du flux à partir de sa position actuelle.

La première fois que cette méthode est appelée après l’initialisation du flux, le compteur de position de flux de l’objet IAudioClient commence à 0. Sinon, l’horloge reprend sa position au moment où le flux a été arrêté pour la dernière fois. La réinitialisation du flux force la position du flux à 0.

Pour éviter les problèmes de démarrage avec les flux de rendu, les clients ne doivent pas appeler Start tant que le moteur audio n’a pas été initialement chargé avec des données en appelant les méthodes IAudioRenderClient ::GetBuffer et IAudioRenderClient ::ReleaseBuffer sur l’interface de rendu.

Pour obtenir des exemples de code qui appellent la méthode Start , consultez les rubriques suivantes :

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête audioclient.h

Voir aussi

IAudioClient Interface

IAudioClient ::Initialize

IAudioRenderClient ::GetBuffer

IAudioRenderClient ::ReleaseBuffer