mixerGetID 函式 (mmeapi.h)

mixerGetID 函式會擷取與指定裝置句柄相關聯的混音器裝置裝置標識碼。

語法

MMRESULT mixerGetID(
  HMIXEROBJ hmxobj,
  UINT      *puMxId,
  DWORD     fdwId
);

hmxobj

要對應至混音器裝置標識碼的音訊混音器物件句柄。

puMxId

接收混合器裝置標識碼之變數的指標。如果 hmxobj 對象沒有混合器裝置可用，值 -1 會放在這個位置，並傳回MMSYSERR_NODRIVER錯誤值。

fdwId

對應混合器物件 hmxobj 的旗標。定義下列值。

值	意義
MIXER_OBJECTF_AUX	hmxobj 參數是零到一個小於 auxGetNumDevs 函式所傳回之裝置數目的輔助裝置識別碼。
MIXER_OBJECTF_HMIDIIN	hmxobj 參數是MIDI輸入裝置的句柄。 midiInOpen 函式必須傳回此句柄。
MIXER_OBJECTF_HMIDIOUT	hmxobj 參數是MIDI輸出裝置的句柄。 midiOutOpen 函式必須傳回此句柄。
MIXER_OBJECTF_HMIXER	hmxobj 參數是混合器Open 函式所傳回的混音器裝置句柄。此旗標是選擇性的。
MIXER_OBJECTF_HWAVEIN	hmxobj 參數是 waveInOpen 函式所傳回的波浪音訊輸入句柄。
MIXER_OBJECTF_HWAVEOUT	hmxobj 參數是 waveOutOpen 函式所傳回的波浪音訊輸出句柄。
MIXER_OBJECTF_MIDIIN	hmxobj 參數是MIDI輸入裝置的標識碼。此標識碼的範圍必須小於 midiInGetNumDevs 函式所傳回的裝置數目。
MIXER_OBJECTF_MIDIOUT	hmxobj 參數是 MIDI 輸出裝置的識別碼。此標識碼的範圍必須小於 midiOutGetNumDevs 函式所傳回的裝置數目。
MIXER_OBJECTF_MIXER	hmxobj 參數是混合器裝置的標識符，範圍介於零到一個小於混合器GetNumDevs 函式所傳回的裝置數目。此旗標是選擇性的。
MIXER_OBJECTF_WAVEIN	hmxobj 參數是零到一個小於 waveInGetNumDevs 函式所傳回之裝置數目的波訊音頻輸入裝置標識碼。
MIXER_OBJECTF_WAVEOUT	hmxobj 參數是介於零到一個小於 waveOutGetNumDevs 函式所傳回之裝置數目的電壓音訊輸出裝置標識碼。

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

傳回碼	Description
MMSYSERR_BADDEVICEID	hmxobj 參數會指定無效的裝置標識碼。
MMSYSERR_INVALFLAG	一或多個旗標無效。
MMSYSERR_INVALHANDLE	hmxobj 參數會指定無效的句柄。
MMSYSERR_INVALPARAM	一或多個參數無效。
MMSYSERR_NODRIVER	hmxobj 所指定的對象沒有音訊混音器裝置可用。 puMxId 所參考的位置也包含 -1 值。