Méthode IPerChannelDbLevel::SetLevelUniform (devicetopology.h)
La méthode SetLevelUniform définit tous les canaux du flux audio au même niveau de volume uniforme, en décibels.
Syntaxe
HRESULT SetLevelUniform(
[in] float fLevelDB,
[in] LPCGUID pguidEventContext
);
Paramètres
[in] fLevelDB
Nouveau niveau uniforme en décibels.
[in] pguidEventContext
Valeur de contexte pour la méthode IControlChangeNotify::OnNotify . Ce paramètre pointe vers un GUID de contexte d’événement. Si l’appel SetLevelUniform modifie l’état du contrôle de niveau, tous les clients qui ont des interfaces IControlChangeNotify inscrites avec ce contrôle reçoivent 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 méthode de notification du client reçoit un pointeur de contexte NULL .
Valeur retournée
Si la méthode réussit, retourne S_OK. 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 |
|---|---|
|
Mémoire insuffisante. |
Notes
Si le niveau uniforme spécifié dépasse la plage que la méthode IPerChannelDbLevel::GetLevelRange signale pour un canal particulier, l’appel SetLevelUniform attache la valeur de ce canal à la plage prise en charge et s’exécute correctement. Un appel suivant à la méthode IPerChannelDbLevel::GetLevel récupère la valeur réelle utilisée pour ce canal.
Spécifications
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | devicetopology.h |