ISpatialAudioObjectRenderStreamBase::GetService-Methode (spatialaudioclient.h)
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 |
|---|---|
|
Der Parameter ppv ist NULL. |
|
Der dem räumlichen Audiostream zugeordnete ISpatialAudioClient wurde zerstört. |
|
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. |
|
Ein interner Fehler ist aufgetreten. |
|
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 |