共用方式為

mixerGetLineInfoW 函式 (mmeapi.h)

  • 發行項

混合器GetLineInfo 函式會擷取混合器裝置特定行的相關資訊。

語法

MMRESULT mixerGetLineInfoW(
  HMIXEROBJ    hmxobj,
  LPMIXERLINEW pmxl,
  DWORD        fdwInfo
);

參數

hmxobj

控制特定音訊線的混音器裝置物件控制碼。

pmxl

混合器LINE結構的指標。 此結構會填入混音器裝置音訊線的相關資訊。 cbStruct成員必須一律初始化為混合器LINE結構的大小，以位元組為單位。

fdwInfo

用來擷取音訊線相關資訊的旗標。 定義下列值。

值 意義
MIXER_GETLINEINFOF_COMPONENTTYPE pmxl參數將會收到在 MIXERLINE結構之 dwComponentType成員中所指定類型之第一個音訊線的相關資訊。 這個旗標是用來擷取特定元件類型的音訊線相關資訊。 cbStruct以外的剩餘結構成員不需要進一步的初始化。
MIXER_GETLINEINFOF_DESTINATION pmxl參數會接收由 MIXERLINE結構dwDestination成員所指定之目的地音訊線的相關資訊。 此索引的範圍從零到小於混合器CAPS結構cDestinations成員中的值。 cbStruct以外的所有剩餘結構成員都不需要進一步的初始化。
MIXER_GETLINEINFOF_LINEID pmxl參數會接收由混合器LINE結構dwLineID成員所指定的音訊線相關資訊。 這通常用來擷取音訊線狀態的更新資訊。 cbStruct以外的所有剩餘結構成員都不需要進一步的初始化。
MIXER_GETLINEINFOF_SOURCE pmxl參數將會收到 DWDestination 和DWSource結構之dwDestination和dwSource成員所指定之來源音訊線的相關資訊。 dwDestination所指定的索引範圍從零到一個小於混合器CAPS結構cDestinations成員中的值。 dwSource所指定的索引範圍從零到一個小於在DWDestination成員中儲存之音訊行的 CConnections成員中的值。 cbStruct以外的所有剩餘結構成員都不需要進一步的初始化。
MIXER_GETLINEINFOF_TARGETTYPE pmxl參數會接收目標結構dwType成員之音訊線的相關資訊，而該成員是MIXERLINE結構的成員。 此旗標可用來擷取處理目標型別 (音訊線的相關資訊，例如 MIXERLINE_TARGETTYPE_WAVEOUT) 。 應用程式必須先初始化 DWType、 wMid、 wPid、 vDriverVersion 和 szPname混合器LINE 結構的成員，再呼叫 混合器GetLineInfo。 所有這些值都可以從所有媒體裝置的裝置功能結構中擷取。 cbStruct以外的剩餘結構成員不需要進一步的初始化。
注意在此函式的 ANSI 版本中， (混合器GetLineInfoA) ，您無法在呼叫具有MIXER_GETLINEINFOF_TARGETTYPE旗標的混合器GetLineInfo或waveOutGetDevCaps時，針對psPname字串的值使用 anSI 字串傳回的 ANSI 字串。 原因是在 Unicode 之間執行內部轉換，這可能會導致資料遺失。
 
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。 可能的錯誤值包括下列專案。

傳回碼 描述
MIXERR_INVALLINE
 音訊行參考無效。
MMSYSERR_BADDEVICEID
 hmxobj參數會指定不正確裝置識別碼。
MMSYSERR_INVALFLAG
 一或多個旗標無效。
MMSYSERR_INVALHANDLE
 hmxobj參數會指定不正確控制碼。
MMSYSERR_INVALPARAM
 一或多個參數無效。
MMSYSERR_NODRIVER
 hmxobj所指定的物件沒有可用的混音器裝置。

備註

注意

mmeapi.h 標頭會將混合器GetLineInfo 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

需求

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

另請參閱

音訊混音器函式

音訊混音器