IAudioEndpointVolume::GetChannelVolumeLevelScalar-Methode (endpointvolume.h)

  • Artikel

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
E_INVALIDARG
 Der Parameter nChannel ist größer oder gleich der Anzahl der Kanäle im Stream.
E_POINTER
 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

Weitere Informationen

IAudioEndpointVolume-Schnittstelle

IAudioEndpointVolume::GetChannelCount