Função de retorno de chamada ACMFORMATENUMCBW (msacm.h)
A função acmFormatEnumCallback especifica uma função de retorno de chamada usada com a função acmFormatEnum . O nome acmFormatEnumCallback é um espaço reservado para o nome da função definida pelo aplicativo.
Sintaxe
ACMFORMATENUMCBW Acmformatenumcbw;
BOOL Acmformatenumcbw(
HACMDRIVERID hadid,
LPACMFORMATDETAILSW pafd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
Parâmetros
hadid
Identificador para o identificador de driver do ACM.
pafd
Ponteiro para uma estrutura ACMFORMATDETAILS que contém os detalhes do formato enumerado para uma marca de formato.
dwInstance
Valor definido pelo aplicativo especificado na função acmFormatEnum .
fdwSupport
Sinalizadores de suporte de driver específicos para o driver identificado pela estrutura ACMDRIVERDETAILS , mas eles são específicos para o formato que está sendo enumerado. Esse parâmetro pode ser uma combinação dos valores a seguir e indica quais operações o driver dá suporte para a marca de formato.
| Valor | Significado |
|---|---|
| ACMDRIVERDETAILS_SUPPORTF_ASYNC | O driver dá suporte a conversões assíncronas com a marca de filtro especificada. |
| ACMDRIVERDETAILS_SUPPORTF_CODEC | O driver dá suporte à conversão entre duas marcas de formato diferentes para o formato especificado. Por exemplo, se um driver der suporte à compactação de WAVE_FORMAT_PCM para WAVE_FORMAT_ADPCM com o formato especificado, esse sinalizador será definido. |
| ACMDRIVERDETAILS_SUPPORTF_CONVERTER | O driver dá suporte à conversão entre dois formatos diferentes da mesma marca de formato ao usar o formato especificado. Por exemplo, se um driver der suporte à reexampção de WAVE_FORMAT_PCM para o formato especificado, esse sinalizador será definido. |
| ACMDRIVERDETAILS_SUPPORTF_FILTER | O driver dá suporte a um filtro (modificação dos dados sem alterar nenhum dos atributos de formato) com o formato especificado. Por exemplo, se um driver der suporte a operações de volume ou eco em WAVE_FORMAT_PCM, esse sinalizador será definido. |
| ACMDRIVERDETAILS_SUPPORTF_HARDWARE | O driver dá suporte à entrada de hardware, à saída ou a ambas as marcas de formato especificadas por meio de um dispositivo de áudio de forma de onda. Um aplicativo deve usar a função acmMetrics com os índices de métrica ACM_METRIC_HARDWARE_WAVE_INPUT e ACM_METRIC_HARDWARE_WAVE_OUTPUT para obter os identificadores de dispositivo waveform-audio associados ao driver ACM de suporte. |
Retornar valor
A função de retorno de chamada deve retornar TRUE para continuar a enumeração ou FALSE para interromper a enumeração.
Comentários
A função acmFormatEnum retornará MMSYSERR_NOERROR (zero) se nenhum formato for enumerado. Além disso, a função de retorno de chamada não será chamada.
As seguintes funções não devem ser chamadas de dentro da função de retorno de chamada: acmDriverAdd, acmDriverRemove e acmDriverPriority.
Observação
O cabeçalho msacm.h define ACMFORMATENUMCB 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
| Requisito | Valor |
|---|---|
| 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 | msacm.h |