IAudioSessionManager::GetSimpleAudioVolume-Methode (audiopolicy.h)

  • Artikel

Die GetSimpleAudioVolume-Methode ruft eine einfache Lautstärkeregelung ab.

Syntax

HRESULT GetSimpleAudioVolume(
  [in]  LPCGUID            AudioSessionGuid,
  [in]  DWORD              StreamFlags,
  [out] ISimpleAudioVolume **AudioVolume
);

Parameter

[in] AudioSessionGuid

Zeiger auf eine Sitzungs-GUID. Wenn die GUID keine sitzung identifiziert, die zuvor geöffnet wurde, öffnet der Aufruf eine neue, aber leere Sitzung. Das Sndvol-Programm zeigt keine Steuerung auf Lautstärkeebene für eine Sitzung an, es sei denn, es enthält einen oder mehrere aktive Streams. Wenn dieser Parameter NULL ist oder auf den Wert GUID_NULL zeigt, weist die Methode den Stream der Standardsitzung zu.

[in] StreamFlags

Gibt an, ob die Anforderung für eine prozessübergreifende Sitzung gilt. Legen Sie auf TRUE fest, wenn die Sitzung prozessübergreifend ist. Legen Sie auf FALSE fest, wenn die Sitzung nicht prozessübergreifend ist.

[out] AudioVolume

Zeiger auf eine Zeigervariable, in die die Methode einen Zeiger auf die ISimpleAudioVolume-Schnittstelle des Audiolautstärkensteuerungsobjekts schreibt. Diese Schnittstelle stellt die einfache Lautstärkeregelung für den aktuellen Prozess dar. Der Aufrufer ist für die Freigabe der Schnittstelle verantwortlich, wenn sie nicht mehr benötigt wird, indem er die Release-Methode der Schnittstelle aufruft. Wenn der Activate-Aufruf fehlschlägt, ist *AudioVolumeNULL.

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
AUDCLNT_E_NOT_INITIALIZED
 Der Audiodatenstrom wurde nicht erfolgreich initialisiert.
AUDCLNT_E_DEVICE_INVALIDATED
 Das Audioendpunktgerät wurde nicht angeschlossen, oder die Audiohardware oder die zugehörigen Hardwareressourcen wurden neu konfiguriert, deaktiviert, entfernt oder anderweitig nicht mehr verfügbar gemacht.
AUDCLNT_E_SERVICE_NOT_RUNNING
 Der Windows-Audiodienst wird nicht ausgeführt.
E_POINTER
 Der AudioVolume-Parameter ist NULL.
E_MEMORY
 Nicht genügend Arbeitsspeicher.

Anforderungen

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

Weitere Informationen

IAudioSessionManager-Schnittstelle

ISimpleAudioVolume-Schnittstelle