音量控制结构MIXERCONTROLDETAILS解释

Platform SDK 中控制系统音量的重要结构MIXERCONTROLDETAILS结构体定义

MIXERCONTROLDETAILS结构体定义 MIXERCONTROLDETAILS typedef struct{ DWORD cbStruct; 指示出MIXERCONTROLDETAILS结构的大小（字节单位），这个大小必须足以包括基本的MIXERCONTROLDETAILS结构。当mixerGetControlDetails返回，该成员包括了返回信息的实际大小。返回信息不超过请求的大小，也不能小于基本的MIXERCONTROLDETAILS结构。 DWORD dwControlID;   将要被获取或设置特性的控制标识符。 DWORD cChannels;   要控制的声道数目，取下列值：   0： 当控制类型为MIXERCONTROL_CONTROLTYPE_CUSTOM 1： 当控制类型为MIXERCONTROL_CONTROLF_UNIFORM时或应用程序要统一地对待所有声道时 MIXERLINE.cChannels：当需要控制一个线路的所有声道时 * 应用程序不能将cChannels定义为（1，音频线路声道数目）区间里的值，例如，对于四声道线路，定义为2、3是非法的。对于非定制（noncustom）控制类型，该值不能为0。 union{  HWND hwndOwner; 混音控制的定制对话框的窗口句柄，该成员用于mixerSetControlDetails函数定义了MIXER_SETCONTROLDETAILSF_CUSTOM标志的时候。  DWORD cMultipleItems;   要控制的声道的每声道乘数项，取下列值： 0： 除了MIXERCONTROL_CONTROLF_MULTIPLE 和MIXERCONTROL_CONTROLTYPE_CUSTOM控制之外，使用“0”值。 MIXERCONTROL.cMultipleItems成员： 当控制类型为MIXERCONTROL_CONTROLF_MULTIPLE时使用该值。   MIXERCONTROLDETAILS.hwndOwner成员： 当控制类型为MIXERCONTROL_CONTROLTYPE_CUSTOM， 并且mixerSetControlDetails函数定义了 MIXER_SETCONTROLDETAILSF_CUSTOM标志的时候使用该值。在这情况下， hwndOwner与cMultipleItems成员一致，提供窗口句柄的值。 * 当使用了MIXERCONTROL_CONTROLTYPE_CUSTOM控制，但没有使用MIXERCONTROL_CONTROLTYPE_CUSTOM标志，该成员定义为“0”。 对于MIXERCONTROL_CONTROLF_MULTIPLE的控制类型，应用程序不能定义与MIXERCONTROL.cMultipleItems成员不一样的值。  }； DWORD cbDetails;   指示出所使用的下列细节结构体之一的大小：   MIXERCONTROLDETAILS_BOOLEAN  音频线路控制的布尔值   MIXERCONTROLDETAILS_LISTTEXT  音频线路控制的list text buffer   MIXERCONTROLDETAILS_SIGNED  音频线路控制的有符号值   MIXERCONTROLDETAILS_UNSIGNED 音频线路控制的无符号值 当使用了MIXERCONTROL_CONTROLTYPE_CUSTOM控制，该成员必须等于MIXERCONTROL.cbCustomData成员。 LPVOID paDetails; 指向一个或多个结构组成的数组的指针，结构中存放着特定控制的属性，可以取得或设置。对于MIXERCONTROL_CONTROLF_MULTIPLE控制，buffer的大小应该是MIXERCONTROLDETAILS 结构体中的cChannels，cMultipleItems和cbDetails 成员的乘积。对于其他的控制类型，buffer的大小应该是MIXERCONTROLDETAILS 结构体中的cChannels和cbDetails 成员的乘积。 对于MIXERCONTROL_CONTROLF_MULTIPLE控制类型，数组可以看作一个以声道为主的二维数组，比如，左声道的所有MultipleItem和右声道的所有MultipleItem。 对于MIXERCONTROL_CONTROLF_MULTIPLE控制类型，每个元素的下标等同于它所影响的声道，即：paDetails[0] 左声道， paDetails[1] 右声道。 如果控制类型为MIXERCONTROL_CONTROLTYPE_CUSTOM，本成员必须指向一个足够容纳MIXERCONTROL结构体里的cbCustomData成员所定义的大小的buffer。 } MIXERCONTROLDETAILS;