共用方式為

mixerGetLineInfo 函式 (mmeapi.h)

  • 發行項

混音器GetLineInfo 函式會擷取混合器裝置特定線的相關信息。

語法

MMRESULT mixerGetLineInfo(
  HMIXEROBJ   hmxobj,
  LPMIXERLINE pmxl,
  DWORD       fdwInfo
);

參數

hmxobj

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

pmxl

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

fdwInfo

擷取音訊線相關信息的旗標。 定義下列值。

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

傳回碼 Description
MIXERR_INVALLINE
 音訊線參考無效。
MMSYSERR_BADDEVICEID
 hmxobj 參數會指定無效的裝置標識碼。
MMSYSERR_INVALFLAG
 一或多個旗標無效。
MMSYSERR_INVALHANDLE
 hmxobj 參數會指定無效的句柄。
MMSYSERR_INVALPARAM
 一或多個參數無效。
MMSYSERR_NODRIVER
 hmxobj 所指定的對象沒有混合器裝置可用。

規格需求

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

另請參閱

音訊混音器函式

音訊混音器