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

  • Article

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
AUDCLNT_E_NOT_INITIALIZED
 Le client n’a pas été correctement initialisé.
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 .

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

Voir aussi

IAudioClient Interface

IAudioClient ::Initialize

IAudioClient ::Reset

IAudioClient ::Start