IAudioSessionManager::GetAudioSessionControl-Methode (audiopolicy.h)
Die GetAudioSessionControl-Methode ruft ein Audiositzungssteuerelement ab.
Syntax
HRESULT GetAudioSessionControl(
[in] LPCGUID AudioSessionGuid,
[in] DWORD StreamFlags,
[out] IAudioSessionControl **SessionControl
);
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 kein Steuerelement auf Volumeebene 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 verweist, weist die Methode den Stream der Standardsitzung zu.
[in] StreamFlags
Gibt die status der Flags für den Audiostream an.
[out] SessionControl
Zeiger auf eine Zeigervariable, in die die Methode einen Zeiger auf die IAudioSessionControl-Schnittstelle des Audiositzungssteuerungsobjekts schreibt. Der Aufrufer ist für das Freigeben der Schnittstelle verantwortlich, wenn sie nicht mehr benötigt wird, indem die Release-Methode der Schnittstelle aufgerufen wird. Wenn der Aufruf fehlschlägt, ist *SessionControlNULL.
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 |
|---|---|
|
Der Audiostream wurde nicht erfolgreich initialisiert. |
|
Das Audioendpunktgerät wurde getrennt, oder die Audiohardware oder die zugehörigen Hardwareressourcen wurden neu konfiguriert, deaktiviert, entfernt oder anderweitig für die Verwendung nicht verfügbar gemacht. |
|
Der Windows-Audiodienst wird nicht ausgeführt. |
|
Der Parameter SessionControl ist NULL. |
|
Nicht genügend Arbeitsspeicher. |
Hinweise
Ein Codebeispiel, das diese Methode aufruft, finden Sie unter Audioereignisse für Legacy-Audioanwendungen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | audiopolicy.h |