auxSetVolume 函式 (mmeapi.h)

auxSetVolume 函式會設定指定輔助輸出裝置的磁碟區。

語法

MMRESULT auxSetVolume(
  UINT  uDeviceID,
  DWORD dwVolume
);

參數

uDeviceID

要查詢之輔助輸出裝置的識別碼。 裝置標識碼會隱含地從系統中存在的裝置數目決定。 裝置標識碼值的範圍從零到一個小於存在的裝置數目。 使用 auxGetNumDevs 函式來判斷系統中的輔助裝置數目。

dwVolume

指定新的磁碟區設定。 低序字會指定左通道磁碟區設定，而高階字則指定右通道設定。 0xFFFF的值代表完整磁碟區，而0x0000的值則為無聲。

如果裝置不支援左右音量控制， dwVolume 的低序字會指定磁碟區層級，並忽略高序字。

傳回值

如果成功或發生錯誤，則傳回MMSYSERR_NOERROR。 可能的錯誤值包括下列專案。

備註

並非所有裝置都支援磁碟區控制。 若要判斷裝置是否支援磁碟區控制，請使用 AUXCAPS_VOLUME 旗標來測試 AUXCAPS 結構的 dwSupport 成員， (由 auxGetDevCaps 函式所填入) 。

若要判斷裝置是否同時支援左右通道上的音量控制，請使用 AUXCAPS_LRVOLUME 旗標來測試 AUXCAPS 結構的 dwSupport 成員， (由 auxGetDevCaps) 填滿。

大部分的裝置都不支援完整的16位磁碟區層級控件，而且只會使用要求磁碟區設定的高序位。 例如，對於支援 4 位磁碟區控制的裝置，要求的磁碟區層級值0x4000、0x4FFF和0x43BE會產生相同的實體磁碟區設定，0x4000。 auxGetVolume 函式會傳回使用 auxSetVolume 設定的完整 16 位設定。

磁碟區設定會對數方式解譯。 這表示當將磁碟區層級從0x5000增加到0x6000時，感知的磁碟區增加與0x4000到0x5000相同。

規格需求

另請參閱

波波音頻

波波函式