MIXERLINECONTROLSA 結構（mmeapi.h）

發行項
11/20/2024

MIXERLINECONTROLS 結構包含音訊線控件的相關信息。

語法

typedef struct tagMIXERLINECONTROLSA {
  DWORD           cbStruct;
  DWORD           dwLineID;
  union {
    DWORD dwControlID;
    DWORD dwControlType;
  } DUMMYUNIONNAME;
  DWORD           cControls;
  DWORD           cbmxctrl;
  LPMIXERCONTROLA pamxctrl;
} MIXERLINECONTROLSA, *PMIXERLINECONTROLSA, *LPMIXERLINECONTROLSA;

成員

cbStruct

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

dwLineID

要查詢控制件的行標識碼。如果未為 mixerGetLineControls 函式指定MIXER_GETLINECONTROLSF_ONEBYID旗標，則不會使用此成員，但混音器裝置在此案例中仍會傳回此成員。指定MIXER_GETLINECONTROLSF_ALL時，不會使用 dwControlID 和 dwControlType 成員。

DUMMYUNIONNAME

DUMMYUNIONNAME.dwControlID

所需控制件的控件識別碼。這個成員會搭配混合器GetLineControls 函式的MIXER_GETLINECONTROLSF_ONEBYID旗標使用，以擷取指定控件的控件資訊。請注意，dwLineIDMIXERLINECONTROLS 結構的成員將由混音器裝置傳回，不需要作為輸入參數。此成員與 dwControlType 成員重疊，無法與MIXER_GETLINECONTROLSF_ONEBYTYPE查詢類型搭配使用。

DUMMYUNIONNAME.dwControlType

所需控制項類型的類別。這個成員會搭配 mixerGetLineControls 函式的MIXER_GETLINECONTROLSF_ONEBYTYPE旗標使用，以擷取 dwLineID 所指定行上指定類別的第一個控件，MIXERLINECONTROLS 結構的成員。此成員與 dwControlID 成員重疊，無法與MIXER_GETLINECONTROLSF_ONEBYID查詢類型搭配使用。請參閱 MIXERCONTROL中的 dwControlType 成員描述。

cControls

要擷取 MIXERCONTROL 結構元素的數目。這個成員必須先由應用程式初始化，才能呼叫 mixerGetLineControls 函式。只有當指定MIXER_GETLINECONTROLSF_ONEBYID或MIXER_GETLINECONTROLSF_ONEBYTYPE，或是針對音訊線傳回的 MIXER LINE 成員 cControls 中傳回的值，這個成員才能是 1。這個成員不可以是零。如果音訊線指定沒有控件，則不應該呼叫混音器GetLineControls。

cbmxctrl

單一 MIXERCONTROL 結構的大小，以位元組為單位。這個成員中指定的大小必須至少夠大，才能包含基底 MIXERCONTROL 結構。 pamxctrl 成員所指向之緩衝區的大小總計，以位元組為單位，是 cbmxctrl 和 cControlsMIXERLINECONTROLS 結構的成員之乘積。

pamxctrl

一或多個 MIXERCONTROL 的指標結構，以接收要求音訊線控件的屬性。這個成員不能 NULL，而且必須在呼叫混音器GetLineControls 函式之前初始化。控件數位的每個元素至少必須夠大，才能包含基底 MIXERCONTROL 結構。 cbmxctrl 成員必須指定此陣列中每個元素的大小，以位元組為單位。應用程式不需要初始化這個成員所指向的緩衝區。所有成員都會由混音器裝置填入（包括成功傳回時，每個 MIXERCONTROL 結構成員 cbStruct。

言論

注意

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

要求

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