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 |
|---|---|
|
音訊線參考無效。 |
|
hmxobj 參數會指定無效的裝置標識碼。 |
|
一或多個旗標無效。 |
|
hmxobj 參數會指定無效的句柄。 |
|
一或多個參數無效。 |
|
hmxobj 所指定的對象沒有混合器裝置可用。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | mmeapi.h (包含 Windows.h) |
| 程式庫 | Winmm.lib |
| Dll | Winmm.dll |