Estrutura MIXERCONTROLA (mmeapi.h)
A estrutura
Sintaxe
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;
Membros
cbStruct
Tamanho, em bytes, da estrutura de
dwControlID
Identificador definido pelo mixer de áudio que se refere exclusivamente ao controle descrito pela estrutura
dwControlType
Classe do controle para o qual o identificador é especificado em dwControlID. Um aplicativo deve usar essas informações para exibir o controle apropriado para entrada do usuário. Um aplicativo também pode exibir gráficos personalizados com base na classe de controle ou pesquisar uma classe de controle específica em uma linha específica. Se um aplicativo não souber sobre uma classe de controle, esse controle deverá ser ignorado. Há oito classificações de classe de controle, cada uma com um ou mais tipos de controle padrão:
fdwControl
Sinalizadores de status e suporte para o controle de linha de áudio. Os seguintes valores são definidos:
cMultipleItems
Número de itens por canal que compõem um controle MIXERCONTROL_CONTROLF_MULTIPLE. Esse número é sempre dois ou maior para controles de vários itens. Se o controle não for um controle de vários itens, não use este membro; será zero.
szShortName[MIXER_SHORT_NAME_CHARS]
Cadeia de caracteres curta que descreve o controle de linha de áudio especificado por dwControlID. Essa descrição deve ser apropriada para usar como um rótulo conciso para o controle.
szName[MIXER_LONG_NAME_CHARS]
Cadeia de caracteres que descreve o controle de linha de áudio especificado por dwControlID. Essa descrição deve ser apropriada para usar como uma descrição completa para o controle.
Bounds
União de tipos de limites.
Bounds.DUMMYSTRUCTNAME
Bounds.DUMMYSTRUCTNAME.lMinimum
Valor mínimo assinado para um controle que tem uma natureza de limite assinada. Esse membro não pode ser usado em conjunto com dwMinimum.
Bounds.DUMMYSTRUCTNAME.lMaximum
Valor máximo assinado para um controle que tem uma natureza de limite assinada. Esse membro não pode ser usado em conjunto com dwMaximum.
Bounds.DUMMYSTRUCTNAME2
Bounds.DUMMYSTRUCTNAME2.dwMinimum
Valor mínimo não assinado para um controle que tem uma natureza de limite sem sinal. Esse membro não pode ser usado em conjunto com lMinimum.
Bounds.DUMMYSTRUCTNAME2.dwMaximum
Valor máximo não assinado para um controle que tem uma natureza de limite sem sinal. Este membro não pode ser usado em conjunto com lMaximum.
Bounds.dwReserved[6]
Reservado; não use.
Metrics
União de métricas de limite.
Metrics.cSteps
Número de intervalos discretos dentro da união especificada para um controle especificado pelo membro limites
Metrics.cbCustomData
Tamanho, em bytes, necessário para conter o estado de uma classe de controle personalizada. Esse membro é apropriado apenas para a classe de controle MIXERCONTROL_CONTROLTYPE_CUSTOM.
Metrics.dwReserved[6]
Reservado; não use.
Observações
Nota
O cabeçalho mmeapi.h define MIXERCONTROL como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
cabeçalho | mmeapi.h |
Consulte também
de Estruturas de Mixer de Áudio
Misturadores de áudio