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
系結成員所指定之控制項的聯集內離散範圍數目。 此成員與 Metrics 結構成員的其他成員重迭,無法與這些成員搭配使用。
Metrics.cbCustomData
大小,以位元組為單位,必須包含自訂控制項類別的狀態。 這個成員僅適用于MIXERCONTROL_CONTROLTYPE_CUSTOM控制項類別。
Metrics.dwReserved[6]
保留;請勿使用。
備註
注意
mmeapi.h 標頭會將 MIXERCONTROL 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
標頭 | mmeapi.h |
另請參閱
音訊混音器