Estructura ACMSTREAMHEADER (msacm.h)
La estructura ACMSTREAMHEADER define el encabezado utilizado para identificar un par de búferes de conversión y origen de conversión de ACM para un flujo de conversión.
Sintaxis
typedef struct tACMSTREAMHEADER {
DWORD cbStruct;
DWORD fdwStatus;
DWORD_PTR dwUser;
LPBYTE pbSrc;
DWORD cbSrcLength;
DWORD cbSrcLengthUsed;
DWORD_PTR dwSrcUser;
LPBYTE pbDst;
DWORD cbDstLength;
DWORD cbDstLengthUsed;
DWORD_PTR dwDstUser;
DWORD dwReservedDriver[_DRVRESERVED];
} ACMSTREAMHEADER, *PACMSTREAMHEADER, *LPACMSTREAMHEADER;
Members
cbStruct
Tamaño, en bytes, de la estructura ACMSTREAMHEADER . Este miembro debe inicializarse antes de que la aplicación llame a cualquier función de secuencia de ACM mediante esta estructura. El tamaño especificado en este miembro debe ser lo suficientemente grande como para contener la estructura base ACMSTREAMHEADER .
fdwStatus
Marcas que dan información sobre los búferes de conversión. Este miembro debe inicializarse en cero antes de que la aplicación llame a la función acmStreamPrepareHeader y no se debe modificar mediante la aplicación mientras el encabezado de secuencia permanece preparado.
| Nombre | Descripción |
|---|---|
|
Establezca por el controlador o ACM para indicar que ha terminado con la conversión y está devolviendo los búferes a la aplicación. |
|
Establezca por el controlador o ACM para indicar que los búferes se ponen en cola para la conversión. |
|
Establezca por el ACM para indicar que los búferes se han preparado mediante la función acmStreamPrepareHeader . |
dwUser
Datos de usuario. Puede ser cualquier dato de instancia especificado por la aplicación.
pbSrc
Puntero al búfer de origen. Este puntero siempre debe hacer referencia a la misma ubicación mientras el encabezado de secuencia permanece preparado. Si una aplicación necesita cambiar la ubicación de origen, debe desaparear el encabezado y volver a prepararlo con la ubicación alternativa.
cbSrcLength
Longitud, en bytes, del búfer de origen al que apunta pbSrc. Cuando se prepara el encabezado, este miembro debe especificar el tamaño máximo que se usará en el búfer de origen. Las conversiones se pueden realizar en longitudes de origen menores o iguales que el tamaño preparado original. Sin embargo, este miembro debe restablecerse al tamaño original cuando una aplicación deja de preparar el encabezado.
cbSrcLengthUsed
Cantidad de datos, en bytes, usados para la conversión. Este miembro no es válido hasta que se complete la conversión. Este valor puede ser menor o igual que cbSrcLength. Una aplicación debe usar el miembro cbSrcLengthUsed al avanzar al siguiente fragmento de datos de origen para el flujo de conversión.
dwSrcUser
Datos de usuario. Puede ser cualquier dato de instancia especificado por la aplicación.
pbDst
Puntero al búfer de destino. Este puntero siempre debe hacer referencia a la misma ubicación mientras el encabezado de secuencia permanece preparado. Si una aplicación necesita cambiar la ubicación de destino, debe desaparear el encabezado y volver a prepararlo con la ubicación alternativa.
cbDstLength
Longitud, en bytes, del búfer de destino al que apunta pbDst. Cuando se prepara el encabezado, este miembro debe especificar el tamaño máximo que se usará en el búfer de destino.
cbDstLengthUsed
Cantidad de datos, en bytes, devueltos por una conversión. Este miembro no es válido hasta que se complete la conversión. Este valor puede ser menor o igual que cbDstLength. Una aplicación debe usar el miembro cbDstLengthUsed al avanzar a la siguiente ubicación de destino para el flujo de conversión.
dwDstUser
Datos de usuario. Puede ser cualquier dato de instancia especificado por la aplicación.
dwReservedDriver[_DRVRESERVED]
Reservado; no usar. Este miembro no requiere ninguna inicialización por parte de la aplicación y nunca debe modificarse mientras el encabezado permanece preparado.
Comentarios
Para poder usar una estructura ACMSTREAMHEADER para una conversión, debe prepararse mediante la función acmStreamPrepareHeader . Cuando una aplicación finaliza con una estructura ACMSTREAMHEADER , debe llamar a la función acmStreamUnprepareHeader antes de liberar los búferes de origen y destino.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado | msacm.h |
Consulte también
Administrador de compresión de audio