Función acmMetrics (msacm.h)

Artículo
08/24/2023

La función acmMetrics devuelve varias métricas para los objetos ACM o ACM relacionados.

Sintaxis

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

Parámetros

hao

Identificador del objeto ACM para consultar la métrica especificada en uMetric. En algunas consultas, este parámetro puede ser NULL.

uMetric

Índice de métrica que se va a devolver en pMetric.

Valor	Significado
ACM_METRIC_COUNT_CODECS	El valor devuelto es el número de controladores globales de compresor o descompresión ACM en el sistema. El parámetro hao debe ser NULL para este índice de métrica. El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD .
ACM_METRIC_COUNT_CONVERTERS	El valor devuelto es el número de controladores de convertidor ACM globales en el sistema. El parámetro hao debe ser NULL para este índice de métrica. El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD .
ACM_METRIC_COUNT_DISABLED	El valor devuelto es el número total de controladores ACM deshabilitados globales (de todos los tipos de soporte) en el sistema. El parámetro hao debe ser NULL para este índice de métrica. El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD . La suma de los índices de métricas de ACM_METRIC_COUNT_DRIVERS y ACM_METRIC_COUNT_DISABLED es el número total de controladores ACM instalados globalmente.
ACM_METRIC_COUNT_DRIVERS	El valor devuelto es el número total de controladores ACM globales habilitados (de todos los tipos de soporte) en el sistema. El parámetro hao debe ser NULL para este índice de métrica. El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD .
ACM_METRIC_COUNT_FILTERS	El valor devuelto es el número de controladores de filtro ACM globales en el sistema. El parámetro hao debe ser NULL para este índice de métrica. El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD .
ACM_METRIC_COUNT_HARDWARE	El valor devuelto es el número de controladores de hardware ACM globales en el sistema. El parámetro hao debe ser NULL para este índice de métrica. El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD .
ACM_METRIC_COUNT_LOCAL_CODECS	El valor devuelto es el número de controladores de compresores ACM locales, controladores de descompresión ACM o ambos para la tarea de llamada. El parámetro hao debe ser NULL para este índice de métrica. El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD .
ACM_METRIC_COUNT_LOCAL_CONVERTERS	El valor devuelto es el número de controladores de convertidor ACM locales para la tarea de llamada. El parámetro hao debe ser NULL para este índice de métrica. El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD .
ACM_METRIC_COUNT_LOCAL_DISABLED	El valor devuelto es el número total de controladores ACM deshabilitados localmente, de todos los tipos de soporte técnico, para la tarea de llamada. El parámetro hao debe ser NULL para este índice de métrica. El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD . La suma de los índices de métricas de ACM_METRIC_COUNT_LOCAL_DRIVERS y ACM_METRIC_COUNT_LOCAL_DISABLED es el número total de controladores ACM instalados localmente.
ACM_METRIC_COUNT_LOCAL_DRIVERS	El valor devuelto es el número total de controladores ACM locales habilitados (de todos los tipos de soporte) para la tarea de llamada. El parámetro hao debe ser NULL para este índice de métrica. El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD .
ACM_METRIC_COUNT_LOCAL_FILTERS	El valor devuelto es el número de controladores de filtro de ACM locales para la tarea de llamada. El parámetro hao debe ser NULL para este índice de métrica. El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD .
ACM_METRIC_DRIVER_PRIORITY	El valor devuelto es la prioridad actual del controlador especificado. El parámetro hao debe ser un identificador de controlador ACM válido del tipo de datos HACMDRIVERID . El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD .
ACM_METRIC_DRIVER_SUPPORT	El valor devuelto es las marcas fdwSupport para el controlador especificado. El parámetro hao debe ser un identificador de controlador ACM válido del tipo de datos HACMDRIVERID . El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD .
ACM_METRIC_HARDWARE_WAVE_INPUT	El valor devuelto es el identificador del dispositivo de entrada de audio de forma de onda asociado al controlador especificado. El parámetro hao debe ser un identificador de controlador ACM válido del tipo de datos HACMDRIVERID que admita la marca de ACMDRIVERDETAILS_SUPPORTF_HARDWARE. Si no hay ningún dispositivo de entrada de audio de forma de onda asociado al controlador, se devuelve MMSYSERR_NOTSUPPORTED. El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD .
ACM_METRIC_HARDWARE_WAVE_OUTPUT	El valor devuelto es el identificador del dispositivo de salida de audio de forma de onda asociado al controlador especificado. El parámetro hao debe ser un identificador de controlador ACM válido del tipo de datos HACMDRIVERID que admita la marca de ACMDRIVERDETAILS_SUPPORTF_HARDWARE. Si no hay ningún dispositivo de salida de audio de forma de onda asociado al controlador, se devuelve MMSYSERR_NOTSUPPORTED. El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD .
ACM_METRIC_MAX_SIZE_FILTER	El valor devuelto es el tamaño de la estructura WAVEFILTER más grande. Si hao es NULL, el valor devuelto es la estructura WAVEFILTER más grande del sistema. Si hao identifica una instancia abierta de un controlador ACM del tipo de datos HACMDRIVER o un identificador de controlador ACM del tipo de datos HACMDRIVERID , se devuelve la estructura WAVEFILTER más grande para ese controlador. El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD . Esta métrica no se permite para un identificador de flujo de ACM del tipo de datos HACMSTREAM .
ACM_METRIC_MAX_SIZE_FORMAT	El valor devuelto es el tamaño de la estructura WAVEFORMATEX más grande. Si hao es NULL, el valor devuelto es la estructura WAVEFORMATEX más grande del sistema. Si hao identifica una instancia abierta de un controlador ACM del tipo de datos HACMDRIVER o un identificador de controlador ACM del tipo de datos HACMDRIVERID , se devuelve la estructura WAVEFORMATEX más grande para ese controlador. El parámetro pMetric debe apuntar a un búfer de un tamaño igual a un valor DWORD . Esta métrica no se permite para un identificador de flujo de ACM del tipo de datos HACMSTREAM .

pMetric

Puntero al búfer para recibir los detalles de la métrica. La definición exacta depende del índice uMetric .

Valor devuelto

Devuelve cero si es correcto o si se produce un error en caso contrario. Entre los valores de error posibles se incluyen los siguientes.

Código devuelto	Descripción
ACMERR_NOTPOSSIBLE	No se puede devolver el índice especificado en uMetric para el hao especificado.
MMSYSERR_INVALHANDLE	El identificador especificado no es válido.
MMSYSERR_INVALPARAM	Al menos un parámetro no es válido.
MMSYSERR_NOTSUPPORTED	No se admite el índice especificado en uMetric .

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msacm.h
Library	Msacm32.lib
Archivo DLL	Msacm32.dll

Consulte también

Funciones de compresión de audio

Administrador de compresión de audio

Compartir a través de