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。 可能的錯誤值包括下列專案。
| 傳回碼 | 描述 |
|---|---|
|
音訊行參考無效。 |
|
hmxobj參數會指定不正確裝置識別碼。 |
|
一或多個旗標無效。 |
|
hmxobj參數會指定不正確控制碼。 |
|
一或多個參數無效。 |
|
hmxobj所指定的物件沒有可用的混音器裝置。 |
備註
注意
mmeapi.h 標頭會將混合器GetLineInfo 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | mmeapi.h (包含 Windows.h) |
| 程式庫 | Winmm.lib |
| Dll | Winmm.dll |