IAudioEndpointVolume::GetChannelVolumeLevelScalar-Methode (endpointvolume.h)
Die GetChannelVolumeLevelScalar-Methode ruft die normalisierte Lautstärkeebene des angegebenen Kanals des Audiodatenstroms ab, der in das Audioendpunktgerät eintritt oder dieses verlässt.
Syntax
HRESULT GetChannelVolumeLevelScalar(
[in] UINT nChannel,
[out] float *pfLevel
);
Parameter
[in] nChannel
Die Kanalnummer. Wenn der Audiodatenstrom n Kanäle enthält, werden die Kanäle zwischen 0 und n bis 1 nummeriert. Rufen Sie die IAudioEndpointVolume::GetChannelCount-Methode auf, um die Anzahl der Kanäle abzurufen.
[out] pfLevel
Zeiger auf eine float-Variable , in die die Methode die Volumeebene schreibt. Die Ebene wird als normalisierter Wert im Bereich von 0,0 bis 1,0 ausgedrückt.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Parameter nChannel ist größer oder gleich der Anzahl der Kanäle im Stream. |
|
Parameter pfLevel ist NULL. |
Hinweise
Die Lautstärke wird auf den Bereich von 0,0 bis 1,0 normalisiert, wobei 0,0 die minimale Lautstärke und 1,0 die maximale Lautstärke ist. Innerhalb dieses Bereichs wird die Beziehung des normalisierten Lautstärkepegels zur Dämpfung der Signalamplitude durch eine nicht lineare, audioverkippte Kurve beschrieben. Beachten Sie, dass sich die Form der Kurve in zukünftigen Versionen von Windows ändern kann. Weitere Informationen zu audioverknippten Kurven finden Sie unter Audio-Lautstärkesteuerungen.
Die normalisierten Lautstärken, die von dieser Methode abgerufen werden, eignen sich für die Darstellung der Positionen von Lautstärkereglern in Anwendungsfenstern und Bildschirmanzeigen.
Anforderungen
| 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 |