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

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