Méthode IAudioClient ::Stop (audioclient.h)
La méthode Stop arrête le flux audio.
Syntaxe
HRESULT Stop();
Valeur de retour
Si la méthode réussit et arrête le flux, elle retourne S_OK. Si la méthode réussit et que le flux a déjà été arrêté, la méthode retourne S_FALSE. 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 client n’a pas été correctement initialisé. |
|
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 .
Stop est une méthode de contrôle qui arrête un flux audio en cours d’exécution. Cette méthode empêche la diffusion en continu des données via la connexion du client avec le moteur audio. L’arrêt du flux fige l’horloge audio du flux à sa position actuelle. Un appel suivant à IAudioClient ::Start entraîne la reprise de l’exécution du flux à partir de cette position. Si nécessaire, le client peut appeler la méthode IAudioClient ::Reset pour réinitialiser la position pendant l’arrêt du flux.
Pour obtenir des exemples de code qui appellent la méthode Stop, 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 |