midiOutGetVolume 函式 (mmeapi.h)

  • 發行項

midiOutGetVolume 函式會擷取 MIDI 輸出裝置目前的磁碟區設定。

語法

MMRESULT midiOutGetVolume(
  HMIDIOUT hmo,
  LPDWORD  pdwVolume
);

參數

hmo

處理開啟的 MIDI 輸出裝置。 只要參數轉換成 HMIDIOUT，此參數也可以包含 MIDI 數據流的句柄。 此參數也可以是裝置標識碼。

pdwVolume

要包含目前磁碟區設定之位置的指標。 這個位置的低序字組包含左通道音量設定，而高序字組則包含右通道設定。 0xFFFF 的值代表完整磁碟區，而0x0000的值則為無聲。

如果裝置不支援左右音量控制，則指定位置的低序字組會包含單聲道音量層級。

不論裝置是否支援該值，都會傳回使用 midiOutSetVolume 函式設定的任何值。

傳回值

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

傳回碼 Description
MMSYSERR_INVALHANDLE
 指定的裝置句柄無效。
MMSYSERR_INVALPARAM
 指定的指標或結構無效。
MMSYSERR_NOMEM
 系統無法配置或鎖定記憶體。
MMSYSERR_NOTSUPPORTED
 不支援函式。

備註

如果使用裝置標識碼， midiOutGetVolume 呼叫的結果和 lpdwVolume 中傳回的資訊會套用至裝置的所有實例。 如果使用裝置句柄，則傳回的結果和資訊只適用於裝置句柄所參考的裝置實例。

並非所有裝置都支援磁碟區控制。 您可以使用 midiOutGetDevCaps 函式和指定MIDICAPS_VOLUME旗標來查詢裝置，以判斷裝置是否支援磁碟區控制。

您也可以使用 midiOutGetDevCaps 函式查詢裝置，並指定MIDICAPS_LRVOLUME旗標，來判斷裝置是否支援左右通道上的音量控制。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 mmeapi.h (包含 Windows.h)
程式庫 Winmm.lib
Dll Winmm.dll

另請參閱

MIDI 函式