Compartir a través de


Función acmMetrics (msacm.h)

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