Función acmFormatTagEnumW (msacm.h)
La función acmFormatTagEnum enumera las etiquetas de formato de onda y audio disponibles en un controlador ACM. Esta función continúa enumerando hasta que no haya etiquetas de formato más adecuadas o la función de devolución de llamada devuelve FALSE.
Sintaxis
MMRESULT ACMAPI acmFormatTagEnumW(
HACMDRIVER had,
LPACMFORMATTAGDETAILSW paftd,
ACMFORMATTAGENUMCBW fnCallback,
DWORD_PTR dwInstance,
DWORD fdwEnum
);
Parámetros
had
Controle al controlador ACM para consultar los detalles de la etiqueta de formato de forma de onda. Si este parámetro es NULL, el ACM usa los detalles del primer controlador ACM adecuado.
paftd
Puntero a la estructura ACMFORMATTAGDETAILS que va a recibir los detalles de etiqueta de formato pasados a la función especificada en fnCallback. Esta estructura debe tener inicializado el miembro cbStruct de la estructura ACMFORMATTAGDETAILS .
fnCallback
Dirección de instancia de procedimiento de la función de devolución de llamada definida por la aplicación.
dwInstance
Valor definido por la aplicación de 64 bits (DWORD_PTR) o de 32 bits (DWORD) que se pasa a la función de devolución de llamada junto con los detalles de la etiqueta de formato ACM.
fdwEnum
Reservados; debe ser cero.
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 |
---|---|
|
Al menos una marca no es válida. |
|
El identificador especificado no es válido. |
|
Al menos un parámetro no es válido. |
Comentarios
Esta función devolverá MMSYSERR_NOERROR (cero) si no hay ningún controlador ACM adecuado instalado. Además, no se llamará a la función de devolución de llamada.
Nota
El encabezado msacm.h define acmFormatTagEnum como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
Requisito | Value |
---|---|
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 |