Metode ISpatialAudioObjectRenderStreamBase::GetService (spatialaudioclient.h)

Artikel
03/04/2024

Mendapatkan layanan tambahan dari ISpatialAudioObjectRenderStream.

Sintaks

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

Parameter

[in] riid

ID antarmuka untuk layanan yang diminta. Klien harus mengatur parameter ini ke salah satu nilai REFIID berikut:

IID_IAudioClock

IID_IAudioClock2

IID_IAudioStreamVolume

[out] service

Pointer ke variabel pointer tempat metode menulis alamat instans antarmuka yang diminta. Melalui metode ini, penelepon mendapatkan referensi yang dihitung ke antarmuka. Pemanggil bertanggung jawab untuk merilis antarmuka, ketika tidak lagi diperlukan, dengan memanggil metode Rilis antarmuka. Jika panggilan GetService gagal, *ppv adalah NULL.

Mengembalikan nilai

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian menyertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode	Deskripsi
E_POINTER	Parameter ppv adalah NULL.
SPTLAUDCLNT_E_DESTROYED	ISpatialAudioClient yang terkait dengan aliran audio spasial telah dihancurkan.
AUDCLNT_E_DEVICE_INVALIDATED	Perangkat titik akhir audio telah dicabut, atau perangkat keras audio atau sumber daya perangkat keras terkait telah dikonfigurasi ulang, dinonaktifkan, dihapus, atau dibuat tidak tersedia untuk digunakan.
SPTLAUDCLNT_E_INTERNAL	Terjadi kesalah internal.
AUDCLNT_E_UNSUPPORTED_FORMAT	Media yang terkait dengan aliran audio spasial menggunakan format yang tidak didukung.

Keterangan

Metode GetService mendukung antarmuka layanan berikut:

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	spatialaudioclient.h

Lihat juga

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase

Bagikan melalui