IAudioEndpointVolume::GetChannelVolumeLevel-Methode (endpointvolume.h)
Die GetChannelVolumeLevel-Methode ruft die Lautstärke des angegebenen Kanals im Audiodatenstrom in Dezibel ab, der in das Audioendpunktgerät eintritt oder dieses verlässt.
Syntax
HRESULT GetChannelVolumeLevel(
[in] UINT nChannel,
[out] float *pfLevelDB
);
Parameter
[in] nChannel
Die Kanalnummer. Wenn der Audiodatenstrom über n Kanäle verfügt, werden die Kanäle von 0 bis n bis 1 nummeriert. Rufen Sie die IAudioEndpointVolume::GetChannelCount-Methode auf, um die Anzahl der Kanäle im Stream abzurufen.
[out] pfLevelDB
Zeiger auf eine float-Variable , in die die -Methode die Lautstärkeebene in Dezibel schreibt. Rufen Sie die IAudioEndpointVolume::GetVolumeRange-Methode auf, um den Bereich der Volumeebenen abzurufen, die von dieser Methode abgerufen werden.
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. |
|
Der Parameter pfLevelDB ist NULL. |
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