Méthode IAudioEndpointVolume::SetMute (endpointvolume.h)
La méthode SetMute définit l’état de désactivation du flux audio qui entre ou sort du périphérique de point de terminaison audio.
Syntaxe
HRESULT SetMute(
[in] BOOL bMute,
[in] LPCGUID pguidEventContext
);
Paramètres
[in] bMute
Nouvel état de désactivation. Si bMute a la valeur TRUE, la méthode désactive le flux. Si la valeur est FALSE, la méthode désactive le muting.
[in] pguidEventContext
Valeur de contexte pour la méthode IAudioEndpointVolumeCallback::OnNotify . Ce paramètre pointe vers un GUID de contexte d’événement. Si l’appel SetMute modifie l’état de désactivation du point de terminaison, tous les clients qui ont des interfaces IAudioEndpointVolumeCallback inscrites avec ce point de terminaison recevront des notifications. Dans son implémentation de la méthode OnNotify , un client peut inspecter le GUID de contexte d’événement pour déterminer s’il est ou un autre client la source de l’événement control-change. Si l’appelant fournit un pointeur NULL pour ce paramètre, la routine de notification reçoit la valeur GUID de contexte GUID_NULL.
Valeur retournée
Si la méthode réussit et que l’état de désactivation change, la méthode retourne S_OK. Si la méthode réussit et que le nouvel état de désactivation est identique à l’état de désactivation précédent, la méthode retourne S_FALSE. Si la méthode échoue, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
Mémoire insuffisante. |
Notes
Pour obtenir un exemple de code qui appelle SetMute, consultez Contrôles de volume de point de terminaison.
Spécifications
| 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 | endpointvolume.h |
Voir aussi
IAudioEndpointVolume, interface