IPerChannelDbLevel::SetLevelUniform-Methode (devicetopology.h)

Die SetLevelUniform-Methode legt alle Kanäle im Audiodatenstrom auf den gleichen gleichmäßigen Lautstärkepegel in Dezibel fest.

Syntax

HRESULT SetLevelUniform(
  [in] float   fLevelDB,
  [in] LPCGUID pguidEventContext
);

Parameter

[in] fLevelDB

Die neue einheitliche Ebene in Dezibel.

[in] pguidEventContext

Kontextwert für die IControlChangeNotify::OnNotify-Methode . Dieser Parameter verweist auf eine Ereigniskontext-GUID. Wenn der SetLevelUniform-Aufruf den Status des Ebenensteuerelements ändert, erhalten alle Clients, die IControlChangeNotify-Schnittstellen mit diesem Steuerelement 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 Steuerelementänderungsereignisses ist. Wenn der Aufrufer einen NULL-Zeiger für diesen Parameter bereitstellt, empfängt die Benachrichtigungsmethode des Clients einen NULL-Kontextzeiger .

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.

Rückgabecode	Beschreibung
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Hinweise

Wenn die angegebene einheitliche Ebene den Bereich überschreitet, den die IPerChannelDbLevel::GetLevelRange-Methode für einen bestimmten Kanal meldet, klemmt der SetLevelUniform-Aufruf den Wert für diesen Kanal in den unterstützten Bereich und wird erfolgreich abgeschlossen. Ein anschließender Aufruf der IPerChannelDbLevel::GetLevel-Methode ruft den tatsächlichen Wert ab, der für diesen Kanal verwendet wird.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	devicetopology.h

Weitere Informationen

IPerChannelDbLevel-Schnittstelle

IPerChannelDbLevel::GetLevel

IPerChannelDbLevel::GetLevelRange