Función acmStreamConvert (msacm.h)
La función acmStreamConvert solicita al ACM que realice una conversión en la secuencia de conversión especificada. Una conversión puede ser sincrónica o asincrónica, dependiendo de cómo se abrió la secuencia.
Sintaxis
MMRESULT ACMAPI acmStreamConvert(
HACMSTREAM has,
LPACMSTREAMHEADER pash,
DWORD fdwConvert
);
Parámetros
has
Identificador de la secuencia de conversión abierta.
pash
Puntero a un encabezado de secuencia que describe los búferes de origen y destino para una conversión. Este encabezado debe haberse preparado previamente mediante la función acmStreamPrepareHeader .
fdwConvert
Marcas para realizar la conversión. Se definen los valores siguientes.
| Valor | Significado |
|---|---|
| ACM_STREAMCONVERTF_BLOCKALIGN | Solo se convertirán números enteros de bloques. Los datos convertidos terminarán en límites alineados en bloques. Una aplicación debe usar esta marca para todas las conversiones de una secuencia hasta que no haya suficientes datos de origen para convertir en un destino alineado con bloques. En este caso, se debe especificar la última conversión sin esta marca. |
| ACM_STREAMCONVERTF_END | El flujo de conversión de ACM debe comenzar a devolver datos de instancia pendientes. Por ejemplo, si un flujo de conversión contiene datos de instancia, como el final de una operación de filtro de eco, esta marca hará que la secuencia empiece a devolver estos datos restantes con datos de origen opcionales. Esta marca se puede especificar con la marca ACM_STREAMCONVERTF_START. |
| ACM_STREAMCONVERTF_START | El flujo de conversión de ACM debe reinicializar sus datos de instancia. Por ejemplo, si un flujo de conversión contiene datos de instancia, como información diferencial o de predicción, esta marca restaurará la secuencia para iniciar los valores predeterminados. Esta marca se puede especificar con la marca ACM_STREAMCONVERTF_END. |
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 |
|---|---|
|
El encabezado de secuencia especificado en pash está actualmente en uso y no se puede reutilizar. |
|
El encabezado de secuencia especificado en pash no está preparado actualmente por la función acmStreamPrepareHeader . |
|
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
Debe usar la función acmStreamPrepareHeader para preparar los búferes de origen y destino antes de pasarlos a acmStreamConvert.
Si el controlador o ACM ponen en cola correctamente una solicitud de conversión asincrónica y la conversión se determina posteriormente como imposible, la estructura ACMSTREAMHEADER se devuelve a la función de devolución de llamada de la aplicación con el miembro cbDstLengthUsed establecido en cero.
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 |