IAudioEndpointVolumeCallback::OnNotify-Methode (endpointvolume.h)

  • Artikel

Die OnNotify-Methode benachrichtigt den Client, dass sich die Lautstärke oder der Stummschaltungszustand des Audioendpunktgeräts geändert hat.

Syntax

HRESULT OnNotify(
  [in] PAUDIO_VOLUME_NOTIFICATION_DATA pNotify
);

Parameter

[in] pNotify

Zeiger auf die Volumebenachrichtigungsdaten. Dieser Parameter verweist auf eine Struktur vom Typ AUDIO_VOLUME_NOTIFICATION_DATA.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

Der Parameter pNotify verweist auf eine Struktur, die das Volumeänderungsereignis beschreibt, das den Aufruf von OnNotify initiiert hat. Diese Struktur enthält eine Ereigniskontext-GUID. Diese GUID ermöglicht es einem Client, zwischen einer Volumeänderung (oder Stummschaltung) zu unterscheiden, die er initiiert hat, und einer Änderung, die von einem anderen Client initiiert wurde. Beim Aufrufen einer IAudioEndpointVolume-Methode , die die Volumeebene des Datenstroms ändert, übergibt ein Client einen Zeiger auf eine Ereigniskontext-GUID, die die Implementierung der OnNotify-Methode erkennen kann. Die Struktur, auf die von pNotify verwiesen wird, enthält diese Kontext-GUID. Wenn der Client, der die Volumeebene ändert, einen NULL-Zeigerwert für den Zeiger auf die Ereigniskontext-GUID bereitstellt, wird der Wert der Ereigniskontext-GUID in der Struktur, auf die pNotify verweist, GUID_NULL.

Windows 7, die Volume-Benutzeroberfläche des Systems, gibt keine GUID_NULL an, wenn das Volume im System geändert wird. Eine OSD-Anwendung eines Drittanbieters kann zwischen master Änderungen der Lautstärkeregelung, die sich aus der Volumebenutzeroberfläche des Systems ergeben, und anderen Volumeänderungen wie Änderungen des integrierten Lautstärkereglerhandlers unterscheiden.

Ein Codebeispiel, das die OnNotify-Methode implementiert, finden Sie unter Endpunktvolumesteuerungen.

Anforderungen

Anforderung Wert
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

AUDIO_VOLUME_NOTIFICATION_DATA

IAudioEndpointVolume-Schnittstelle

IAudioEndpointVolumeCallback-Schnittstelle