Função mixerGetLineInfoA (mmeapi.h)
A função mixerGetLineInfo recupera informações sobre uma linha específica de um dispositivo de mixer.
Sintaxe
MMRESULT mixerGetLineInfoA(
HMIXEROBJ hmxobj,
LPMIXERLINEA pmxl,
DWORD fdwInfo
);
Parâmetros
hmxobj
Manipule para o objeto de dispositivo do mixer que controla a linha de áudio específica.
pmxl
Ponteiro para uma estrutura MIXERLINE . Essa estrutura é preenchida com informações sobre a linha de áudio para o dispositivo de mixer. O membro cbStruct sempre deve ser inicializado para ser o tamanho, em bytes, da estrutura MIXERLINE .
fdwInfo
Sinalizadores para recuperar informações sobre uma linha de áudio. Os valores a seguir são definidos.
| Valor | Significado |
|---|---|
| MIXER_GETLINEINFOF_COMPONENTTYPE | O parâmetro pmxl receberá informações sobre a primeira linha de áudio do tipo especificado no membro dwComponentType da estrutura MIXERLINE . Esse sinalizador é usado para recuperar informações sobre uma linha de áudio de um tipo de componente específico. Os membros restantes da estrutura, exceto cbStruct , não exigem nenhuma inicialização adicional. |
| MIXER_GETLINEINFOF_DESTINATION | O parâmetro pmxl receberá informações sobre a linha de áudio de destino especificada pelo membro dwDestination da estrutura MIXERLINE . Esse índice varia de zero a um a menos do que o valor no membro cDestinations da estrutura MIXERCAPS . Todos os membros restantes da estrutura, exceto cbStruct , não exigem nenhuma inicialização adicional. |
| MIXER_GETLINEINFOF_LINEID | O parâmetro pmxl receberá informações sobre a linha de áudio especificada pelo membro dwLineID da estrutura MIXERLINE . Isso geralmente é usado para recuperar informações atualizadas sobre o estado de uma linha de áudio. Todos os membros restantes da estrutura, exceto cbStruct , não exigem nenhuma inicialização adicional. |
| MIXER_GETLINEINFOF_SOURCE | O parâmetro pmxl receberá informações sobre a linha de áudio de origem especificada pelos membros dwDestination e dwSource da estrutura MIXERLINE . O índice especificado por dwDestination varia de zero a um menor que o valor no membro cDestinations da estrutura MIXERCAPS . O índice especificado por dwSource varia de zero a um menor que o valor no membro cConnections da estrutura MIXERLINE retornada para a linha de áudio armazenada no membro dwDestination . Todos os membros restantes da estrutura, exceto cbStruct , não exigem nenhuma inicialização adicional. |
| MIXER_GETLINEINFOF_TARGETTYPE | O parâmetro pmxl receberá informações sobre a linha de áudio que é para o membro dwType da estrutura Target , que é um membro da estrutura MIXERLINE . Esse sinalizador é usado para recuperar informações sobre uma linha de áudio que manipula o tipo de destino (por exemplo, MIXERLINE_TARGETTYPE_WAVEOUT). O aplicativo deve inicializar os membros dwType, wMid, wPid, vDriverVersion e szPname da estrutura MIXERLINE antes de chamar mixerGetLineInfo. Todos esses valores podem ser recuperados das estruturas de funcionalidades do dispositivo para todos os dispositivos de mídia. Os membros restantes da estrutura, exceto cbStruct , não exigem nenhuma inicialização adicional.
Nota Na versão ANSI dessa função (mixerGetLineInfoA), você não pode usar a cadeia de caracteres ANSI retornada de mixerGetLineInfo ou waveOutGetDevCaps para o valor da cadeia de caracteres psPname ao chamar mixerGetLineInfo com o sinalizador MIXER_GETLINEINFOF_TARGETTYPE . O motivo é que uma conversão interna de e para Unicode é executada, o que pode resultar em perda de dados.
|
| MIXER_OBJECTF_AUX | O parâmetro hmxobj é um identificador de dispositivo auxiliar no intervalo de zero a um a menos do que o número de dispositivos retornados pela função auxGetNumDevs . |
| MIXER_OBJECTF_HMIDIIN | O parâmetro hmxobj é o identificador de um dispositivo de entrada MIDI. Esse identificador deve ter sido retornado pela função midiInOpen . |
| MIXER_OBJECTF_HMIDIOUT | O parâmetro hmxobj é o identificador de um dispositivo de saída MIDI. Esse identificador deve ter sido retornado pela função midiOutOpen . |
| MIXER_OBJECTF_HMIXER | O parâmetro hmxobj é um identificador de dispositivo de mixer retornado pela função mixerOpen . Esse sinalizador é opcional. |
| MIXER_OBJECTF_HWAVEIN | O parâmetro hmxobj é um identificador de entrada waveform-audio retornado pela função waveInOpen . |
| MIXER_OBJECTF_HWAVEOUT | O parâmetro hmxobj é um identificador de saída waveform-audio retornado pela função waveOutOpen . |
| MIXER_OBJECTF_MIDIIN | O parâmetro hmxobj é o identificador de um dispositivo de entrada MIDI. Esse identificador deve estar no intervalo de zero a um menor que o número de dispositivos retornados pela função midiInGetNumDevs . |
| MIXER_OBJECTF_MIDIOUT | O parâmetro hmxobj é o identificador de um dispositivo de saída MIDI. Esse identificador deve estar no intervalo de zero a um menor que o número de dispositivos retornados pela função midiOutGetNumDevs . |
| MIXER_OBJECTF_MIXER | O parâmetro hmxobj é um identificador de dispositivo de mixer no intervalo de zero a um menor que o número de dispositivos retornados pela função mixerGetNumDevs . Esse sinalizador é opcional. |
| MIXER_OBJECTF_WAVEIN | O parâmetro hmxobj é o identificador de um dispositivo de entrada waveform-audio no intervalo de zero a um a menos do que o número de dispositivos retornados pela função waveInGetNumDevs . |
| MIXER_OBJECTF_WAVEOUT | O parâmetro hmxobj é o identificador de um dispositivo de saída waveform-audio no intervalo de zero a um a menos do que o número de dispositivos retornados pela função waveOutGetNumDevs . |
Valor retornado
Retorna MMSYSERR_NOERROR se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.
| Código de retorno | Descrição |
|---|---|
|
A referência de linha de áudio é inválida. |
|
O parâmetro hmxobj especifica um identificador de dispositivo inválido. |
|
Um ou mais sinalizadores são inválidos. |
|
O parâmetro hmxobj especifica um identificador inválido. |
|
Um ou mais parâmetros são inválidos. |
|
Nenhum dispositivo de mixer está disponível para o objeto especificado por hmxobj. |
Comentários
Observação
O cabeçalho mmeapi.h define mixerGetLineInfo como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | mmeapi.h (inclua Windows.h) |
| Biblioteca | Winmm.lib |
| DLL | Winmm.dll |
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de