MIXERLINEA 結構 (mmeapi.h)

發行項
03/05/2024

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

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

dwDestination

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

dwSource

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

dwLineID

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

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) 的 CD-ROM。
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 (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_TARGETTYPE_MIDIIN	MIXERLINE 結構所描述的音訊線，嚴格系結至混合器結構之目標結構成員其餘成員中詳述的MIDI輸入設備。
MIXERLINE_TARGETTYPE_MIDIOUT	MIXERLINE 結構所描述的音訊線，嚴格系結至混合器結構之目標結構成員其餘成員中詳述的MIDI輸出裝置。
MIXERLINE_TARGETTYPE_UNDEFINED	MIXERLINE 結構所描述的音訊線不會嚴格系結至定義的媒體類型。應該忽略混合器LINE結構的所有剩餘目標結構成員。使用 MIXER_GETLINEINFOF_TARGETTYPE 旗標呼叫混合器GetLineInfo 函式時，應用程式無法使用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 成員相同。製造商標識碼定義於製造商和產品標識碼中。

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 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	mmeapi.h

另請參閱

音訊混音器

共用方式為

MIXERLINEA 結構 (mmeapi.h)

語法

成員

備註

規格需求

另請參閱

意見反應

意見反應

其他資源