MIXERCONTROLA 結構 （mmeapi.h）

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

語法

typedef struct tagMIXERCONTROLA {
  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;
} MIXERCONTROLA, *PMIXERCONTROLA, *LPMIXERCONTROLA;

成員

cbStruct

大小，以位元組為單位，MIXERCONTROL 結構。

dwControlID

音訊混音器定義的標識碼，可唯一參考 MIXERCONTROL 結構中所述的控制件。 此標識碼可以是混音器裝置所支援的任何格式。 應用程式應該只使用此標識碼做為抽象句柄。 單一混音器裝置的兩個控件都不能有相同的控制標識碼。

dwControlType

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

fdwControl

音訊行控件的狀態和支援旗標。 定義下列值：

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]

保留;請勿使用 。

言論

要求

另請參閱

音訊混音器結構

音訊混音器

MIXERLINECONTROLS

混合器GetLineControls