Função acmMetrics (msacm.h)

Artigo
08/24/2023

A função acmMetrics retorna várias métricas para o ACM ou objetos ACM relacionados.

Sintaxe

MMRESULT ACMAPI acmMetrics(
  HACMOBJ hao,
  UINT    uMetric,
  LPVOID  pMetric
);

Parâmetros

hao

Manipule para o objeto ACM a ser consultado para a métrica especificada em uMetric. Para algumas consultas, esse parâmetro pode ser NULL.

uMetric

Índice de métrica a ser retornado em pMetric.

Valor	Significado
ACM_METRIC_COUNT_CODECS	O valor retornado é o número de drivers globais de compressor ou descompactador do ACM no sistema. O parâmetro hao deve ser NULL para esse índice de métrica. O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD .
ACM_METRIC_COUNT_CONVERTERS	O valor retornado é o número de drivers globais de conversor de ACM no sistema. O parâmetro hao deve ser NULL para esse índice de métrica. O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD .
ACM_METRIC_COUNT_DISABLED	O valor retornado é o número total de drivers ACM desabilitados globais (de todos os tipos de suporte) no sistema. O parâmetro hao deve ser NULL para esse índice de métrica. O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD . A soma dos índices de métrica ACM_METRIC_COUNT_DRIVERS e ACM_METRIC_COUNT_DISABLED é o número total de drivers do ACM instalados globalmente.
ACM_METRIC_COUNT_DRIVERS	O valor retornado é o número total de drivers ACM globais habilitados (de todos os tipos de suporte) no sistema. O parâmetro hao deve ser NULL para esse índice de métrica. O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD .
ACM_METRIC_COUNT_FILTERS	O valor retornado é o número de drivers de filtro ACM globais no sistema. O parâmetro hao deve ser NULL para esse índice de métrica. O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD .
ACM_METRIC_COUNT_HARDWARE	O valor retornado é o número de drivers globais de hardware do ACM no sistema. O parâmetro hao deve ser NULL para esse índice de métrica. O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD .
ACM_METRIC_COUNT_LOCAL_CODECS	O valor retornado é o número de drivers de compressor ACM locais, drivers de descompactador do ACM ou ambos para a tarefa de chamada. O parâmetro hao deve ser NULL para esse índice de métrica. O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD .
ACM_METRIC_COUNT_LOCAL_CONVERTERS	O valor retornado é o número de drivers de conversor de ACM locais para a tarefa de chamada. O parâmetro hao deve ser NULL para esse índice de métrica. O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD .
ACM_METRIC_COUNT_LOCAL_DISABLED	O valor retornado é o número total de drivers ACM desabilitados locais, de todos os tipos de suporte, para a tarefa de chamada. O parâmetro hao deve ser NULL para esse índice de métrica. O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD . A soma dos índices de métrica ACM_METRIC_COUNT_LOCAL_DRIVERS e ACM_METRIC_COUNT_LOCAL_DISABLED é o número total de drivers ACM instalados localmente.
ACM_METRIC_COUNT_LOCAL_DRIVERS	O valor retornado é o número total de drivers ACM locais habilitados (de todos os tipos de suporte) para a tarefa de chamada. O parâmetro hao deve ser NULL para esse índice de métrica. O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD .
ACM_METRIC_COUNT_LOCAL_FILTERS	O valor retornado é o número de drivers de filtro ACM locais para a tarefa de chamada. O parâmetro hao deve ser NULL para esse índice de métrica. O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD .
ACM_METRIC_DRIVER_PRIORITY	O valor retornado é a prioridade atual para o driver especificado. O parâmetro hao deve ser um identificador de driver ACM válido do tipo de dados HACMDRIVERID . O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD .
ACM_METRIC_DRIVER_SUPPORT	O valor retornado é os sinalizadores fdwSupport para o driver especificado. O parâmetro hao deve ser um identificador de driver ACM válido do tipo de dados HACMDRIVERID . O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD .
ACM_METRIC_HARDWARE_WAVE_INPUT	O valor retornado é o identificador de dispositivo de entrada waveform-audio associado ao driver especificado. O parâmetro hao deve ser um identificador de driver ACM válido do tipo de dados HACMDRIVERID que dê suporte ao sinalizador ACMDRIVERDETAILS_SUPPORTF_HARDWARE. Se nenhum dispositivo de entrada waveform-audio estiver associado ao driver, MMSYSERR_NOTSUPPORTED será retornado. O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD .
ACM_METRIC_HARDWARE_WAVE_OUTPUT	O valor retornado é o identificador do dispositivo de saída waveform-audio associado ao driver especificado. O parâmetro hao deve ser um identificador de driver ACM válido do tipo de dados HACMDRIVERID que dê suporte ao sinalizador ACMDRIVERDETAILS_SUPPORTF_HARDWARE. Se nenhum dispositivo de saída waveform-audio estiver associado ao driver, MMSYSERR_NOTSUPPORTED será retornado. O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD .
ACM_METRIC_MAX_SIZE_FILTER	O valor retornado é o tamanho da maior estrutura WAVEFILTER . Se hao for NULL, o valor retornado será a maior estrutura WAVEFILTER do sistema. Se hao identificar uma instância aberta de um driver ACM do tipo de dados HACMDRIVER ou um identificador de driver ACM do tipo de dados HACMDRIVERID , a maior estrutura WAVEFILTER para esse driver será retornada. O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD . Essa métrica não é permitida para um identificador de fluxo do ACM do tipo de dados HACMSTREAM .
ACM_METRIC_MAX_SIZE_FORMAT	O valor retornado é o tamanho da maior estrutura WAVEFORMATEX . Se hao for NULL, o valor retornado será a maior estrutura WAVEFORMATEX do sistema. Se hao identificar uma instância aberta de um driver ACM do tipo de dados HACMDRIVER ou um identificador de driver ACM do tipo de dados HACMDRIVERID , a maior estrutura WAVEFORMATEX para esse driver será retornada. O parâmetro pMetric deve apontar para um buffer de um tamanho igual a um valor DWORD . Essa métrica não é permitida para um identificador de fluxo do ACM do tipo de dados HACMSTREAM .

pMetric

Ponteiro para o buffer para receber os detalhes da métrica. A definição exata depende do índice uMetric .

Valor retornado

Retorna zero se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.

Código de retorno	Descrição
ACMERR_NOTPOSSIBLE	O índice especificado em uMetric não pode ser retornado para o hao especificado.
MMSYSERR_INVALHANDLE	O identificador especificado é inválido.
MMSYSERR_INVALPARAM	Pelo menos um parâmetro é inválido.
MMSYSERR_NOTSUPPORTED	Não há suporte para o índice especificado em uMetric .

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	msacm.h
Biblioteca	Msacm32.lib
DLL	Msacm32.dll

Confira também

Funções de compactação de áudio

Gerenciador de Compactação de Áudio

Compartilhar via