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.

Notes

Pour obtenir un exemple de code qui appelle SetMute, consultez Contrôles de volume de point de terminaison.

Spécifications

Voir aussi

IAudioEndpointVolume, interface

IAudioEndpointVolumeCallback, interface

IAudioEndpointVolumeCallback::OnNotify