ISpatialAudioObjectRenderStreamBase::GetService-Methode (spatialaudioclient.h)

Artikel
03/02/2024

Ruft zusätzliche Dienste aus ISpatialAudioObjectRenderStream ab.

Syntax

HRESULT GetService(
  [in]  REFIID riid,
  [out] void   **service
);

Parameter

[in] riid

Die Schnittstellen-ID für den angeforderten Dienst. Der Client sollte diesen Parameter auf einen der folgenden REFIID-Werte festlegen:

IID_IAudioClock

IID_IAudioClock2

IID_IAudioStreamVolume

[out] service

Zeiger auf eine Zeigervariable, in die die Methode die Adresse eines instance der angeforderten Schnittstelle schreibt. Mit dieser Methode erhält der Aufrufer einen gezählten Verweis auf die Schnittstelle. 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 GetService-Aufruf fehlschlägt, ist *ppv NULL.

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
E_POINTER	Der Parameter ppv ist NULL.
SPTLAUDCLNT_E_DESTROYED	Der dem räumlichen Audiostream zugeordnete ISpatialAudioClient wurde zerstört.
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.
SPTLAUDCLNT_E_INTERNAL	Ein interner Fehler ist aufgetreten.
AUDCLNT_E_UNSUPPORTED_FORMAT	Die Dem räumlichen Audiostream zugeordneten Medien verwenden ein nicht unterstütztes Format.

Hinweise

Die GetService-Methode unterstützt die folgenden Dienstschnittstellen:

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	spatialaudioclient.h

Weitere Informationen

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase

Share via