ISpatialAudioObjectRenderStreamBase：：GetService 方法 (spatialaudioclient.h)

從 ISpatialAudioObjectRenderStream 取得其他服務。

語法

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

[in] riid

所要求服務的介面標識碼。客戶端應該將此參數設定為下列其中一個 REFIID 值：

IID_IAudioClock

IID_IAudioClock2

IID_IAudioStreamVolume

[out] service

指標變數的指標，方法會將所要求介面實例的位址寫入其中。透過這個方法，呼叫端會取得介面的計數參考。呼叫端會藉由呼叫介面的 Release 方法，負責釋放不再需要的介面。如果 GetService 呼叫失敗， *ppv 為 NULL。

如果方法成功，它會傳回 S_OK。如果失敗，可能的傳回碼包括但不限於下表所示的值。

傳回碼	Description
E_POINTER	參數 ppv 為 NULL。
SPTLAUDCLNT_E_DESTROYED	與空間音頻數據流相關聯的 ISpatialAudioClient 已終結。
AUDCLNT_E_DEVICE_INVALIDATED	音訊端點裝置已解除叢集，或音訊硬體或相關聯的硬體資源已重新設定、停用、移除或無法使用。
SPTLAUDCLNT_E_INTERNAL	發生內部錯誤。
AUDCLNT_E_UNSUPPORTED_FORMAT	與空間音訊數據流相關聯的媒體會使用不支援的格式。

GetService 方法支援下列服務介面：

需求	值
目標平台	Windows
標頭	spatialaudioclient.h