MIXERLINEA 結構 （mmeapi.h）

MIXERLINE 結構描述音訊線的狀態和計量。

語法

typedef struct tagMIXERLINEA {
  DWORD     cbStruct;
  DWORD     dwDestination;
  DWORD     dwSource;
  DWORD     dwLineID;
  DWORD     fdwLine;
  DWORD_PTR dwUser;
  DWORD     dwComponentType;
  DWORD     cChannels;
  DWORD     cConnections;
  DWORD     cControls;
  CHAR      szShortName[MIXER_SHORT_NAME_CHARS];
  CHAR      szName[MIXER_LONG_NAME_CHARS];
  struct {
    DWORD     dwType;
    DWORD     dwDeviceID;
    WORD      wMid;
    WORD      wPid;
    MMVERSION vDriverVersion;
    CHAR      szPname[MAXPNAMELEN];
  } Target;
} MIXERLINEA, *PMIXERLINEA, *LPMIXERLINEA;

成員

cbStruct

大小，以位元組為單位，MIXERLINE 結構。 呼叫 混合器GetLineInfo 函式之前，必須先初始化這個成員。 這個成員中指定的大小必須夠大，才能包含 MIXERLINE 結構。 當 混合器GetLineInfo 傳回時，這個成員會包含傳回之資訊的實際大小。 傳回的資訊不會超過要求的大小。

dwDestination

目的地行索引。 這個成員的範圍從零到一個小於 cDestinations 中指定的值，MIXERCAPS 結構的成員，混合器GetDevCaps 函式所擷取。 當使用 MIXER_GETLINEINFOF_DESTINATION 旗標呼叫 混合器GetLineInfo 函式時，會傳回目的地行的屬性。 （在此案例中，dwSource 成員必須設定為零。使用 MIXER_GETLINEINFOF_SOURCE 旗標呼叫時，會傳回與 dwDestination 成員相關聯的 dwSource 成員所指定來源的屬性。

dwSource

與 dwDestination 成員相關聯的音訊來源行索引。 也就是說，這個成員會指定與指定音訊目的地行相關聯的音訊來源行 n。 這個成員不會用於目的地行，而且必須在 混合器GetLineInfo 函式中指定MIXER_GETLINEINFOF_DESTINATION時設定為零。 指定MIXER_GETLINEINFOF_SOURCE旗標時，此成員的範圍從零到一個小於 cConnections 成員中所指定之 dwDestination 成員中指定的音訊目的地行值。

dwLineID

由混音器裝置定義的標識碼，該標識符會唯一參考 MIXERLINE 結構中所述的音訊線。 此標識元對於每個混音器裝置而言都是唯一的，而且可以是任何格式。 應用程式應該只使用此標識碼做為抽象句柄。

fdwLine

音訊行的狀態和支援旗標。 此成員一律會傳回至應用程式，而且不需要初始化。

名字	描述
MIXERLINE_LINEF_ACTIVE	音訊線為使用中。 使用中線表示訊號可能通過該線。
MIXERLINE_LINEF_DISCONNECTED	音訊線路已中斷連線。 中斷連線的線條關聯控件仍可修改，但變更在連接該行之前沒有任何作用。
MIXERLINE_LINEF_SOURCE	音訊線是與單一音訊目的地線相關聯的音訊來源線。 如果未設定此旗標，則此行是與零或多個音訊來源行相關聯的音訊目的地行。

 

如果應用程式未使用超聲波音頻輸出裝置，則與該裝置相關聯的音訊線不會作用中（亦即不會設定MIXERLINE_LINEF_ACTIVE旗標）。

如果開啟超聲波音頻輸出裝置，則會將音訊線視為使用中，並設定MIXERLINE_LINEF_ACTIVE旗標。

暫停或饑餓的超聲波音頻輸出裝置仍被視為作用中。 換句話說，如果不論數據是否正在播放，應用程式都會開啟超聲波音頻輸出裝置，則會將相關聯的音訊線視為使用中。

如果一行不能嚴格定義為使用中，混音器裝置一律會設定MIXERLINE_LINEF_ACTIVE旗標。

dwUser

由音訊裝置為該行定義的實例數據。 此成員適用於專為傳回這項資訊的混音器裝置而設計的自定義混音器應用程式。 其他應用程式應該忽略此數據。

dwComponentType

這個音訊線的元件類型。 應用程式可以使用這項信息來顯示量身打造的圖形，或搜尋特定元件。 如果應用程式不使用元件類型，則應該忽略此成員。 這個成員可以是下列其中一個值：

名字	描述
MIXERLINE_COMPONENTTYPE_DST_DIGITAL	音訊線是數位目的地（例如，DAT 或 CD 音訊裝置的數位輸入）。
MIXERLINE_COMPONENTTYPE_DST_HEADPHONES	音訊線是一個可調整的（增益和/或衰減）目的地，旨在驅動耳機。 大部分音訊卡都會針對喇叭和耳機使用相同的音訊目的地線，在此情況下，混音器裝置只會使用MIXERLINE_COMPONENTTYPE_DST_SPEAKERS類型。
MIXERLINE_COMPONENTTYPE_DST_LINE	音訊線是一個線路層級目的地（例如，來自CD音訊裝置的線路層級輸入），將成為類比數位轉換器（ADC）的最終錄音來源。 因為大部分個人計算機的音訊卡都會為錄製音訊來源線提供某種收益，因此混音器裝置會使用MIXERLINE_COMPONENTTYPE_DST_WAVEIN類型。
MIXERLINE_COMPONENTTYPE_DST_MONITOR	音訊線是用於監視的目的地。
MIXERLINE_COMPONENTTYPE_DST_SPEAKERS	音訊線路是可調整的（增益和/或衰減）目的地，旨在驅動喇叭。 這是個人電腦的音訊輸出音訊輸出的一般元件類型。
MIXERLINE_COMPONENTTYPE_DST_TELEPHONE	音訊線路是將路由傳送至電話線的目的地。
MIXERLINE_COMPONENTTYPE_DST_UNDEFINED	音訊線是無法由其中一個標準元件類型定義的目的地。 混音器裝置必須使用這個元件類型，才能用於尚未由 Microsoft Corporation 定義的線路元件類型。
MIXERLINE_COMPONENTTYPE_DST_VOICEIN	音訊線是一個目的地，將成為語音輸入的最終錄製來源。 此元件類型與MIXERLINE_COMPONENTTYPE_DST_WAVEIN完全相同，但特別適用於錄音/辨識期間所使用的設定。 對於混音器裝置，支援這一行是選擇性的。 許多混音器裝置只提供MIXERLINE_COMPONENTTYPE_DST_WAVEIN。
MIXERLINE_COMPONENTTYPE_DST_WAVEIN	音訊線是一個目的地，將成為電壓音頻輸入（ADC）的最終錄音來源。 這一行通常提供某種增益或衰減。 這是個人電腦大部分音訊卡錄製線的一般元件類型。
MIXERLINE_COMPONENTTYPE_SRC_ANALOG	音訊線是類比來源（例如，來自視訊盒磁帶的模擬輸出）。
MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY	音訊線是源自輔助音訊線的來源。 此線條類型是作為可路由傳送至MIXERLINE_COMPONENTTYPE_DST_SPEAKERS目的地和/或從MIXERLINE_COMPONENTTYPE_DST_WAVEIN目的地記錄的增益或衰減的來源。
MIXERLINE_COMPONENTTYPE_SRC_COMPACTDISC	音訊線是源自內部音訊 CD 輸出的來源。 這個元件類型是針對提供音訊來源線的音訊卡所提供，其旨在連接到音訊CD（或 CD-ROM 播放音訊CD）。
MIXERLINE_COMPONENTTYPE_SRC_DIGITAL	音訊線是數位來源（例如 DAT 或音訊 CD 的數位輸出）。
MIXERLINE_COMPONENTTYPE_SRC_LINE	音訊線是一種線路層級來源（例如，外部立體聲的線路層級輸入），可作為選擇性錄製來源。 因為大部分個人計算機的音訊卡都會為錄音來源線提供某種收益，因此混音器裝置會使用MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY類型。
MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE	音訊線是麥克風錄製來源。 適用於個人計算機的大多數音訊卡至少提供兩種類型的錄音來源：輔助音訊線路和麥克風輸入。 麥克風音訊線路通常提供某種收益。 使用單一輸入搭配麥克風或輔助音訊線使用的音訊卡應該使用MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE元件類型。
MIXERLINE_COMPONENTTYPE_SRC_PCSPEAKER	音訊線路是源自個人電腦喇叭的來源。 適用於個人電腦的數張音訊卡可讓您將通常會在內部喇叭上播放的內容與音訊卡的輸出混合。 某些音訊卡支援使用此輸出做為錄製來源的能力。
MIXERLINE_COMPONENTTYPE_SRC_SYNTHESIZER	音訊線是源自內部合成器輸出的來源。 大部分個人計算機的音訊卡都提供某種 MIDI 合成器。
MIXERLINE_COMPONENTTYPE_SRC_TELEPHONE	音訊線路是源自內送電話線的來源。
MIXERLINE_COMPONENTTYPE_SRC_UNDEFINED	音訊線是無法由其中一個標準元件類型定義的來源。 混音器裝置必須使用這個元件類型，才能用於尚未由 Microsoft Corporation 定義的線路元件類型。
MIXERLINE_COMPONENTTYPE_SRC_WAVEOUT	音訊線是源自電壓音訊輸出數位對模擬轉換器（DAC）的來源。 適用於個人計算機的大多數音訊卡都會將此元件類型作為MIXERLINE_COMPONENTTYPE_DST_SPEAKERS目的地的來源。 有些卡片也允許此來源路由傳送至MIXERLINE_COMPONENTTYPE_DST_WAVEIN目的地。

cChannels

可以針對音訊線獨立操作的個別通道數目上限。 此欄位的最小值為 1，因為一行必須至少有一個通道。

個人計算機的大多數現代音訊卡都是立體聲設備;對於它們，這個成員的值是 2。

通道 1 假設為左通道;通道 2 假設為正確的通道。

多通道線可能會有一或多個統一控件（控件會統一影響該線路的所有通道），且與它相關聯。

cConnections

與音訊線相關聯的連線數目。 這個成員僅用於音訊目的地行，並指定與其相關聯的音訊來源行數目。 對於來源行，以及沒有與其相關聯的任何音訊來源行的目的地行，這個成員一律為零。

cControls

與音訊線相關聯的控件數目。 這個值可以是零。 如果沒有控件與線條相關聯，該行可能是在MIXERCONTROL_CONTROLTYPE_MUX或MIXERCONTROL_CONTROLTYPE_MIXER中選取的來源，但不允許操作訊號。

szShortName[MIXER_SHORT_NAME_CHARS]

簡短字串，描述 dwLineID 成員中指定的音訊混音器行。 此描述應適當作為行的簡潔標籤。

szName[MIXER_LONG_NAME_CHARS]

字串，描述 dwLineID 成員中指定的音訊混音器行。 此描述應適當地做為該行的完整描述。

Target

目標媒體資訊。

Target.dwType

目標媒體裝置類型與 MIXERLINE 結構中所述的音訊線相關聯。 應用程式必須忽略它未使用之媒體裝置類型的目標資訊。 定義下列值：

名字	描述
MIXERLINE_TARGETTYPE_AUX	MIXERLINE 結構所描述的音訊線，嚴格系結至 MIXERLINE 結構中其餘成員 目標 結構成員中詳述的輔助裝置。
MIXERLINE_TARGETTYPE_MIDIIN	MIXERLINE 結構所描述的音訊線，會嚴格系結至 TARGET 結構成員中，MIXERLINE 結構的其餘成員中詳述的 MIDI 輸入設備。
MIXERLINE_TARGETTYPE_MIDIOUT	MIXERLINE 結構所描述的音訊線，嚴格系結至 TARGET 結構成員 MIXERLINE 結構的其餘成員中詳述的 MIDI 輸出裝置。
MIXERLINE_TARGETTYPE_UNDEFINED	MIXERLINE 結構所描述的音訊線並未嚴格系結至定義的媒體類型。 應該忽略所有剩餘 Target structure 成員 MIXERLINE 結構的成員。 當呼叫具有 MIXER_GETLINEINFOF_TARGETTYPE 旗標的 mixerGetLineInfo 函式時，應用程式無法使用MIXERLINE_TARGETTYPE_UNDEFINED目標類型。
MIXERLINE_TARGETTYPE_WAVEIN	MIXERLINE 結構所描述的音訊線嚴格系結至 目標 結構成員 結構其餘成員中詳述 的超聲波音頻輸入設備。
MIXERLINE_TARGETTYPE_WAVEOUT	MIXERLINE 結構所描述的音訊線，嚴格系結至 目標 結構 結構其餘成員中詳述 的超聲波音頻輸出裝置。

Target.dwDeviceID

當 dwType 成員不是MIXERLINE_TARGETTYPE_UNDEFINED以外的目標類型時，目標媒體裝置的目前裝置標識符。 此標識碼與相關聯媒體裝置的目前媒體裝置索引相同。 使用 MIXER_GETLINEINFOF_TARGETTYPE 旗標呼叫 混音器GetLineInfo 函式時，輸入上會忽略此成員，並由音訊混音器管理員傳回給呼叫端。

Target.wMid

當 dwType 成員不是MIXERLINE_TARGETTYPE_UNDEFINED的目標類型時，目標媒體裝置的製造商標識符。 此標識碼與相關聯媒體之裝置功能結構的 wMid 成員相同。 製造商標識碼定義於 Manufacturer 和 Product Identifiers中。

Target.wPid

當 dwType 成員不是MIXERLINE_TARGETTYPE_UNDEFINED的目標類型時，目標媒體裝置的產品識別符。 此標識碼與相關聯媒體之裝置功能結構的 wPid 成員相同。 產品標識碼定義於 製造商和產品識別碼中。

Target.vDriverVersion

當 dwType 成員是非MIXERLINE_TARGETTYPE_UNDEFINED的目標類型時，目標媒體裝置的驅動程式版本。 此版本與相關聯媒體之裝置功能結構的 vDriverVersion 成員相同。

Target.szPname[MAXPNAMELEN]

當 dwType 成員不是MIXERLINE_TARGETTYPE_UNDEFINED的目標類型時，目標媒體裝置的產品名稱。 此名稱與相關聯媒體之裝置功能結構的 szPname 成員相同。

言論

注意

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

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	mmeapi.h

另請參閱

音訊混音器結構

音訊混音器

MIXERCAPS

混音器GetDevCaps

混合器GetLineInfo