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
ACMSTREAMHEADER_STATUSF_DONE	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.
ACMSTREAMHEADER_STATUSF_INQUEUE	Establezca por el controlador o ACM para indicar que los búferes se ponen en cola para la conversión.
ACMSTREAMHEADER_STATUSF_PREPARED	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

Estructuras de compresión de audio

acmStreamPrepareHeader

acmStreamUnprepareHeader