IAudioEndpointVolume::SetChannelVolumeLevelScalar-Methode (endpointvolume.h)
Die SetChannelVolumeLevelScalar-Methode legt den normalisierten Lautstärkepegel des angegebenen Kanals im Audiostream fest, der in das Audioendpunktgerät eintritt oder dieses verlässt.
Syntax
HRESULT SetChannelVolumeLevelScalar(
[in] UINT nChannel,
[in] float fLevel,
[in] LPCGUID pguidEventContext
);
Parameter
[in] nChannel
Die Kanalnummer. Wenn der Audiostream n Kanäle enthält, werden die Kanäle von 0 bis n – 1 nummeriert. Um die Anzahl der Kanäle abzurufen, rufen Sie die IAudioEndpointVolume::GetChannelCount-Methode auf.
[in] fLevel
Die Volumeebene. Die Volumeebene wird als normalisierter Wert im Bereich von 0,0 bis 1,0 ausgedrückt.
[in] pguidEventContext
Kontextwert für die IAudioEndpointVolumeCallback::OnNotify-Methode . Dieser Parameter verweist auf eine Ereigniskontext-GUID. Wenn der SetChannelVolumeLevelScalar-Aufruf die Volumeebene des Endpunkts ändert, erhalten alle Clients, die IAudioEndpointVolumeCallback-Schnittstellen mit diesem Endpunkt registriert haben, Benachrichtigungen. Bei der Implementierung der OnNotify-Methode kann ein Client die Ereigniskontext-GUID überprüfen, um zu ermitteln, ob er oder ein anderer Client die Quelle des Volumeänderungsereignisses ist. Wenn der Aufrufer einen NULL-Zeiger für diesen Parameter bereitstellt, empfängt die Benachrichtigungsroutine den Kontext-GUID-Wert GUID_NULL.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn die Methode fehlschlägt, können mögliche Rückgabecodes die werte in der folgenden Tabelle enthalten, sind jedoch nicht darauf beschränkt.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Parameter nChannel ist größer als oder gleich der Anzahl der Kanäle im Stream. oder der Parameter fLevel liegt außerhalb des Bereichs von 0,0 bis 1,0. |
|
Nicht genügend Arbeitsspeicher. |
Hinweise
Die Volumeebene wird auf den Bereich von 0,0 bis 1,0 normalisiert, wobei 0,0 die minimale Lautstärke und 1,0 der maximale Pegel ist. Innerhalb dieses Bereichs wird die Beziehung des normalisierten Lautstärkepegels zur Dämpfung der Signalamplitude durch eine nichtlineare, audioverkippte Kurve beschrieben. Beachten Sie, dass sich die Form der Kurve in zukünftigen Versionen von Windows ändern kann. Weitere Informationen zu Audioverknüngungskurven finden Sie unter Audioverknen von Lautstärkesteuerungen.
Die normalisierten Lautstärkepegel, die an diese Methode übergeben werden, sind geeignet, die Positionen von Lautstärkereglern in Anwendungsfenstern und Bildschirmanzeigen darzustellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | endpointvolume.h |
Weitere Informationen
IAudioEndpointVolume-Schnittstelle
IAudioEndpointVolume::GetChannelCount