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.

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 :

• Rendu d’un Stream
• Capture d’un Stream

Configuration requise

Voir aussi

IAudioClient Interface

IAudioClient ::Initialize

IAudioClient ::Reset

IAudioClient ::Start