IAudioEndpointVolume::SetChannelVolumeLevelScalar-Methode (endpointvolume.h)

  • Artikel

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
E_INVALIDARG
 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.
E_OUTOFMEMORY
 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

IAudioEndpointVolumeCallback-Schnittstelle

IAudioEndpointVolumeCallback::OnNotify