共用方式為


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

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 呼叫失敗, *ppvNULL

傳回值

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

傳回碼 Description
E_POINTER
參數 ppvNULL
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 物件的相同線程釋出服務。

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

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

規格需求

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

另請參閱

IAudioCaptureClient 介面

IAudioClient 介面

IAudioClient::Initialize

IAudioClock 介面

IAudioRenderClient 介面

IAudioSessionControl 介面

IAudioStreamVolume 介面

IChannelAudioVolume 介面

ISimpleAudioVolume 介面