Méthode IAudioClient ::Start (audioclient.h)
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 |
|---|---|
|
Le flux audio n’a pas été initialisé avec succès. |
|
Le flux audio n’a pas été arrêté au moment de l’appel de démarrage . |
|
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. |
|
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. |
|
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 |