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

  • Article

La méthode Reset réinitialise le flux audio.

Syntaxe

HRESULT Reset();

Valeur de retour

Si la méthode réussit, retourne S_OK. Si la méthode réussit et que le flux a déjà été réinitialisé, 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 flux audio n’a pas été correctement initialisé.
AUDCLNT_E_NOT_STOPPED
 Le flux audio n’a pas été arrêté au moment de l’appel.
AUDCLNT_E_BUFFER_OPERATION_PENDING
 Le client est en cours d’écriture ou de lecture à partir de la mémoire tampon.
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 .

Reset est une méthode de contrôle que le client appelle pour réinitialiser un flux audio arrêté. La réinitialisation du flux vide toutes les données en attente et rétablit la position du flux d’horloge audio à 0. Cette méthode échoue si elle est appelée sur un flux qui n’est pas arrêté.

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