共用方式為

MIXERLINECONTROLSW 結構 (mmeapi.h)

  • 發行項

MIXERLINECONTROLS結構包含音訊線控制項的相關資訊。

語法

typedef struct tagMIXERLINECONTROLSW {
  DWORD           cbStruct;
  DWORD           dwLineID;
  union {
    DWORD dwControlID;
    DWORD dwControlType;
  } DUMMYUNIONNAME;
  DWORD           cControls;
  DWORD           cbmxctrl;
  LPMIXERCONTROLW pamxctrl;
} MIXERLINECONTROLSW, *PMIXERLINECONTROLSW, *LPMIXERLINECONTROLSW;

成員

cbStruct

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

dwLineID

正在查詢控制項的行識別碼。 如果為 混合器GetLineControls 函式指定了MIXER_GETLINECONTROLSF_ONEBYID旗標，但混音器裝置在此案例中仍會傳回這個成員，則不會使用此成員。 指定MIXER_GETLINECONTROLSF_ALL時，不會使用 dwControlID 和 dwControlType 成員。

DUMMYUNIONNAME

DUMMYUNIONNAME.dwControlID

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

DUMMYUNIONNAME.dwControlType

所需 控制項類型的類別。 這個成員會與混合器GetLineControls 函式的MIXER_GETLINECONTROLSF_ONEBYTYPE旗標搭配使用，以擷取在一行上，以在「混合器LINECONTROLS」結構之 dwLineID成員所指定的行上擷取指定類別的第一個控制項。 此成員與 dwControlID 成員重迭，無法與MIXER_GETLINECONTROLSF_ONEBYID查詢類型搭配使用。 請參閱 MIXERCONTROL中的 dwControlType 成員描述。

cControls

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

cbmxctrl

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

pamxctrl

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

備註

注意

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

需求

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

另請參閱

音訊混音器結構

音訊混音器

MIXERCONTROL

混合器線

混合器GetLineControls