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.

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

Weitere Informationen

IPerChannelDbLevel-Schnittstelle

IPerChannelDbLevel::GetLevel

IPerChannelDbLevel::GetLevelRange