Función acmFilterDetails (msacm.h)
La función acmFilterDetails consulta el ACM para obtener más información sobre un filtro con una etiqueta de filtro de formato de onda específica.
Sintaxis
MMRESULT ACMAPI acmFilterDetails(
HACMDRIVER had,
LPACMFILTERDETAILS pafd,
DWORD fdwDetails
);
Parámetros
had
Identificador del controlador ACM para consultar los detalles del filtro de formato de onda para una etiqueta de filtro. Si este parámetro es NULL, el ACM usa los detalles del primer controlador de ACM adecuado.
pafd
Puntero a la estructura ACMFILTERDETAILS que va a recibir los detalles del filtro de la etiqueta de filtro especificada.
fdwDetails
Marcas para obtener los detalles. Se definen los valores siguientes.
[ACMFILTERDETAILS] () se ha proporcionado la estructura y se deben devolver los detalles restantes. El miembro dwFilterTag de la estructura ACMFILTERDETAILS debe inicializarse en la misma etiqueta de filtro que especifica pwfltr . Este tipo de consulta se puede usar para obtener una descripción de cadena de una estructura de filtro arbitraria. Si una aplicación especifica un identificador de controlador de ACM para el que se tenía, se devolverán detalles sobre el filtro para ese controlador. Si una aplicación especifica NULL para , el ACM busca el primer controlador aceptable para devolver los detalles.| Valor | Significado |
|---|---|
| ACM_FILTERDETAILSF_FILTER | |
| ACM_FILTERDETAILSF_INDEX | Se ha proporcionado un índice de filtro para la etiqueta de filtro en el miembro dwFilterIndex de la estructura ACMFILTERDETAILS . Los detalles del filtro se devolverán en la estructura definida por pafd. El índice va de cero a uno menor que el miembro cStandardFilters devuelto en la estructura ACMFILTERTAGDETAILS para una etiqueta de filtro. Una aplicación debe especificar un identificador de controlador para el que se tenía al recuperar los detalles del filtro con esta marca. Para obtener información sobre qué miembros se deben inicializar antes de llamar a esta función, vea la estructura ACMFILTERDETAILS . |
Valor devuelto
Devuelve cero si es correcto o si se produce un error de lo contrario. Entre los posibles valores de error se incluyen los siguientes.
| Código devuelto | Descripción |
|---|---|
|
Los detalles solicitados no están disponibles. |
|
Al menos una marca no es válida. |
|
El identificador especificado no es válido. |
|
Al menos un parámetro no es válido. |
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 |