共用方式為

IAudioSessionManager：：GetSimpleAudioVolume 方法 (audiopolicy.h)

  • 發行項

GetSimpleAudioVolume 方法會擷取簡單的音訊音量控件。

語法

HRESULT GetSimpleAudioVolume(
  [in]  LPCGUID            AudioSessionGuid,
  [in]  DWORD              StreamFlags,
  [out] ISimpleAudioVolume **AudioVolume
);

參數

[in] AudioSessionGuid

會話 GUID 的指標。 如果 GUID 未識別先前開啟的工作階段，則呼叫會開啟新的但空白的工作階段。 除非會話包含一或多個作用中的數據流，否則 Sndvol 程式不會顯示會話的磁碟區層級控件。 如果此參數為 NULL 或指向值GUID_NULL，方法會將數據流指派給預設會話。

[in] StreamFlags

指定要求是否適用於跨進程工作階段。 如果會話是跨進程，則設定為 TRUE 。 如果會話不是跨進程，請設定為 FALSE 。

[out] AudioVolume

指標變數的指標，方法會將指標寫入音訊音量控件物件的 ISimpleAudioVolume 介面。 這個介面代表目前進程的簡單音訊音量控制。 呼叫端會藉由呼叫介面的 Release 方法，負責釋放不再需要的介面。 如果 Activate 呼叫失敗， *AudioVolume 為 NULL。

傳回值

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

傳回碼 Description
AUDCLNT_E_NOT_INITIALIZED
 音訊數據流尚未成功初始化。
AUDCLNT_E_DEVICE_INVALIDATED
 音訊端點裝置已解除叢集，或音訊硬體或相關聯的硬體資源已重新設定、停用、移除或無法使用。
AUDCLNT_E_SERVICE_NOT_RUNNING
 Windows 音訊服務未執行。
E_POINTER
 參數 AudioVolume 為 NULL。
E_MEMORY
 記憶體不足。

規格需求

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

另請參閱

IAudioSessionManager 介面

ISimpleAudioVolume 介面