MIXERCONTROL 結構 (mmeapi.h)

MIXERCONTROL結構描述音訊線單一控制項的狀態和計量。

語法

typedef struct tMIXERCONTROL {
  DWORD cbStruct;
  DWORD dwControlID;
  DWORD dwControlType;
  DWORD fdwControl;
  DWORD cMultipleItems;
  char  szShortName[MIXER_SHORT_NAME_CHARS];
  char  szName[MIXER_LONG_NAME_CHARS];
  union {
    struct {
      LONG lMinimum;
      LONG lMaximum;
    } DUMMYSTRUCTNAME;
    struct {
      DWORD dwMinimum;
      DWORD dwMaximum;
    } DUMMYSTRUCTNAME2;
    DWORD dwReserved[6];
  } Bounds;
  union {
    DWORD cSteps;
    DWORD cbCustomData;
    DWORD dwReserved[6];
  } Metrics;
} MIXERCONTROL, *PMIXERCONTROL, *LPMIXERCONTROL;

成員

cbStruct

混合器CONTROL結構的大小，以位元組為單位。

dwControlID

音訊混音器定義的識別碼，可唯一參考 MIXERCONTROL 結構所描述的控制項。 此識別碼可以是混音器裝置所支援的任何格式。 應用程式應該只使用此識別碼做為抽象控制碼。 單一混音器裝置沒有任何兩個控制項可以具有相同的控制識別碼。

dwControlType

在 dwControlID中指定識別碼之控制項的類別。 應用程式必須使用這項資訊來顯示使用者輸入的適當控制項。 應用程式也可以根據控制項類別顯示量身打造的圖形，或在特定線條上搜尋特定控制項類別。 如果應用程式不知道控制項類別，則必須忽略此控制項。 有八個控制項類別分類，每個分類都有一或多個標準控制項類型：

名稱	描述
MIXERCONTROL_CT_CLASS_CUSTOM	MIXERCONTROL_CONTROLTYPE_CUSTOM
MIXERCONTROL_CT_CLASS_FADER	MIXERCONTROL_CONTROLTYPE_BASS MIXERCONTROL_CONTROLTYPE_EQUALIZER MIXERCONTROL_CONTROLTYPE_FADER MIXERCONTROL_CONTROLTYPE_TREBLE MIXERCONTROL_CONTROLTYPE_VOLUME
MIXERCONTROL_CT_CLASS_LIST	MIXERCONTROL_CONTROLTYPE_MIXER MIXERCONTROL_CONTROLTYPE_MULTIPLESELECT MIXERCONTROL_CONTROLTYPE_MUX MIXERCONTROL_CONTROLTYPE_SINGLESELECT
MIXERCONTROL_CT_CLASS_METER	MIXERCONTROL_CONTROLTYPE_BOOLEANMETER MIXERCONTROL_CONTROLTYPE_PEAKMETER MIXERCONTROL_CONTROLTYPE_SIGNEDMETER MIXERCONTROL_CONTROLTYPE_UNSIGNEDMETER
MIXERCONTROL_CT_CLASS_NUMBER	MIXERCONTROL_CONTROLTYPE_DECIBELS MIXERCONTROL_CONTROLTYPE_PERCENT MIXERCONTROL_CONTROLTYPE_SIGNED MIXERCONTROL_CONTROLTYPE_UNSIGNED
MIXERCONTROL_CT_CLASS_SLIDER	MIXERCONTROL_CONTROLTYPE_PAN MIXERCONTROL_CONTROLTYPE_QSOUNDPAN MIXERCONTROL_CONTROLTYPE_SLIDER
MIXERCONTROL_CT_CLASS_SWITCH	MIXERCONTROL_CONTROLTYPE_BOOLEAN MIXERCONTROL_CONTROLTYPE_BUTTON MIXERCONTROL_CONTROLTYPE_LOUDNESS MIXERCONTROL_CONTROLTYPE_MONO MIXERCONTROL_CONTROLTYPE_MUTE MIXERCONTROL_CONTROLTYPE_ONOFF MIXERCONTROL_CONTROLTYPE_STEREOENH
MIXERCONTROL_CT_CLASS_TIME	MIXERCONTROL_CONTROLTYPE_MICROTIME MIXERCONTROL_CONTROLTYPE_MILLITIME

fdwControl

音訊線控制項的狀態和支援旗標。 已定義下列值：

名稱	描述
MIXERCONTROL_CONTROLF_DISABLED	控制項已停用，可能是因為混合器硬體的其他設定而無法使用。 應用程式可以從停用的控制項讀取目前的設定，但無法套用設定。
MIXERCONTROL_CONTROLF_MULTIPLE	控制項每個通道有兩個以上的設定。 例如，等等化程式需要此旗標，因為每個頻率帶都可以設定為不同的值。 以統一方式影響兩條身歷聲線通道的等等化程式也會指定MIXERCONTROL_CONTROLF_UNIFORM旗標。
MIXERCONTROL_CONTROLF_UNIFORM	控制項會以統一的方式處理多通道線的所有通道。 例如，將身歷聲線的兩個通道設為靜音的控制項會設定此旗標。 大部分MIXERCONTROL_CONTROLTYPE_MUX和MIXERCONTROL_CONTROLTYPE_MIXER控制項也會指定MIXERCONTROL_CONTROLF_UNIFORM旗標。

cMultipleItems

組成MIXERCONTROL_CONTROLF_MULTIPLE控制項的每個通道專案數目。 多專案控制項的這個數位一律為兩個或更大。 如果控制項不是多專案控制項，請勿使用此成員;它將會是零。

szShortName[MIXER_SHORT_NAME_CHARS]

描述 dwControlID所指定之音訊線條控制項的簡短字串。 此描述應該適合用來做為控制項的精簡標籤。

szName[MIXER_LONG_NAME_CHARS]

描述 dwControlID所指定之音訊行控制項的字串。 此描述應該適合用來做為控制項的完整描述。

Bounds

界限類型的聯集。

Bounds.DUMMYSTRUCTNAME

Bounds.DUMMYSTRUCTNAME.lMinimum

具有帶正負號界限本質之控制項的最小帶正負號值。 此成員無法與 dwMinimum搭配使用。

Bounds.DUMMYSTRUCTNAME.lMaximum

具有帶正負號界限本質之控制項的最大帶正負號值。 此成員無法與 dwMaximum搭配使用。

Bounds.DUMMYSTRUCTNAME2

Bounds.DUMMYSTRUCTNAME2.dwMinimum

具有不帶正負號界限本質之控制項的最小不帶正負號值。 此成員無法與 lMinimum搭配使用。

Bounds.DUMMYSTRUCTNAME2.dwMaximum

具有不帶正負號界限本質之控制項的最大不帶正負號值。 此成員無法與 lMaximum搭配使用。

Bounds.dwReserved[6]

保留;請勿使用 。

Metrics

界限計量的聯集。

Metrics.cSteps

Bounds成員所指定控制項之等位內的離散範圍數目。 此成員與 Metrics 結構成員的其他成員重迭，無法與這些成員搭配使用。

Metrics.cbCustomData

大小，以位元組為單位，必須包含自訂控制項類別的狀態。 這個成員只適用于MIXERCONTROL_CONTROLTYPE_CUSTOM控制項類別。

Metrics.dwReserved[6]

保留;請勿使用 。

需求

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

另請參閱

音訊混音器結構

音訊混音器

MIXERLINECONTROLS

混合器GetLineControls