(audioclient.h) 的 IAudioClient：：GetService 方法

發行項
03/13/2024

GetService 方法會從音訊客戶端物件存取其他服務。

語法

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

參數

[in] riid

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

IID_IAudioCaptureClient

IID_IAudioClientDuckingControl

IID_IAudioClock

IID_IAudioRenderClient

IID_IAudioSessionControl

IID_IAudioStreamVolume

IID_IChannelAudioVolume

IID_IMFTrustedOutput

IID_ISimpleAudioVolume

如需詳細資訊，請參閱＜備註＞。

[out] ppv

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

傳回值

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

傳回碼	Description
E_POINTER	參數 ppv 為 NULL。
E_NOINTERFACE	要求的介面無法使用。
AUDCLNT_E_NOT_INITIALIZED	音訊數據流尚未初始化。
AUDCLNT_E_WRONG_ENDPOINT_TYPE	呼叫端嘗試存取轉譯端點上的 IAudioCaptureClient 介面，或擷取端點上的 IAudioRenderClient 介面。
AUDCLNT_E_DEVICE_INVALIDATED	音訊端點裝置已解除叢集，或音訊硬體或相關聯的硬體資源已重新設定、停用、移除或無法使用。
AUDCLNT_E_SERVICE_NOT_RUNNING	Windows 音訊服務未執行。

備註

這個方法需要 IAudioClient 介面的先前初始化。此方法的所有呼叫都會失敗，併發生錯誤AUDCLNT_E_NOT_INITIALIZED，直到用戶端成功呼叫 IAudioClient：：Initialize 方法來初始化音頻數據流為止。

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

在 Windows 7 中，已新增新的服務標識碼 IID_IMFTrustedOutput，可協助使用輸出信任授權單位 (OTA) 物件。這些物件可以在媒體基礎的受保護媒體路徑內部或外部運作， (PMP) 並在 Media Foundation 管線外部傳送內容。如果呼叫端位於 PMP 外部，則 OTA 可能不會在 PMP 中運作，而且保護設定較不健全。 OTA 必須實作 IMFTrustedOutput 介面。藉由在 GetService 中傳遞IID_IMFTrustedOutput，應用程式可以擷取物件之 IMFTrustedOutput 介面的指標。如需受保護物件和 IMFTrustedOutput的詳細資訊，請參閱媒體基礎 SDK 檔中的。

如需在 OTA 中使用受信任音訊驅動程式的相關信息，請參閱受保護的使用者模式音訊 (PUMA) 。

請注意，不論呼叫端是否在 PMP 中執行，透過這項機制啟用 IMFTrustedOutput 都能運作。不過，如果呼叫端未在受保護的進程中執行， (也就是說，呼叫端不在媒體基礎的 PMP 內) 則音訊 OTA 可能無法在 PMP 中運作，且保護設定較不健全。

若要取得服務介面的介面標識碼，請使用 __uuidof 運算符。例如， IAudioCaptureClient 的介面標識碼定義如下：


const IID IID_IAudioCaptureClient  __uuidof(IAudioCaptureClient)

如需 __uuidof 運算符的相關信息，請參閱 Windows SDK 檔。

若要釋放 IAudioClient 物件並釋放其所有相關聯的資源，用戶端除了呼叫 IAudioClient 介面本身呼叫 Release 之外，還必須釋放所有透過呼叫 GetService 所建立之服務對象的參考。客戶端必須從釋放 IAudioClient 物件的相同線程釋出服務。

IAudioSessionControl、IAudioStreamVolume、IChannelAudioVolume 和 ISimpleAudioVolume 介面控制及監視音訊會話和共用模式數據流的各個層面。這些介面不適用於獨佔模式數據流。

如需呼叫 GetService 方法的程式代碼範例，請參閱下列主題：

規格需求

需求	值
最低支援的用戶端	Windows Vista [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	audioclient.h