Función mmioCreateChunk (mmiscapi.h)

La función mmioCreateChunk crea un fragmento en un archivo RIFF que se abrió mediante la función mmioOpen . El nuevo fragmento se crea en la posición del archivo actual. Una vez creado el nuevo fragmento, la posición del archivo actual es el principio de la parte de datos del nuevo fragmento.

Sintaxis

MMRESULT mmioCreateChunk(
  HMMIO      hmmio,
  LPMMCKINFO pmmcki,
  UINT       fuCreate
);

Parámetros

hmmio

Identificador de archivo de un archivo RIFF abierto.

pmmcki

Puntero a un búfer que recibe una estructura MMCKINFO que contiene información sobre el fragmento que se va a crear.

fuCreate

Marcas que identifican el tipo de fragmento que se va a crear. Se definen los valores siguientes.

Valor Significado
MMIO_CREATELIST Fragmento "LIST".
MMIO_CREATERIFF Fragmento "RIFF".

Valor devuelto

Devuelve MMSYSERR_NOERROR si se realiza correctamente o si se produce un error en caso contrario. Entre los valores de error posibles se incluyen los siguientes.

Código devuelto Descripción
MMIOERR_CANNOTSEEK
No se puede determinar el desplazamiento de la parte de datos del fragmento.
MMIOERR_CANNOTWRITE
No se puede escribir el encabezado de fragmento.

Comentarios

Esta función no puede insertar un fragmento en el medio de un archivo. Si una aplicación intenta crear un fragmento en algún lugar que no sea al final de un archivo, mmioCreateChunk sobrescribe la información existente en el archivo.

La estructura MMCKINFO a la que apunta el parámetro lpck debe configurarse de la siguiente manera:

  • El miembro ckid especifica el identificador del fragmento. Si wFlags incluye MMIO_CREATERIFF o MMIO_CREATELIST, este miembro se rellenará mediante mmioCreateChunk.
  • El miembro cksize especifica el tamaño de la parte de datos del fragmento, incluido el tipo de formulario o el tipo de lista (si existe). Si este valor no es correcto cuando se llama a la función mmioAscend para marcar el final del fragmento, mmioAscend corrige el tamaño del fragmento.
  • El miembro fccType especifica el tipo de formulario o el tipo de lista si el fragmento es un fragmento "RIFF" o "LIST". Si el fragmento no es un fragmento "RIFF" o "LIST", este miembro no tiene que rellenarse.
  • No es necesario rellenar el miembro dwDataOffset . La función mmioCreateChunk rellena este miembro con el desplazamiento de archivo de la parte de datos del fragmento.
  • No es necesario rellenar el miembro dwFlags . La función mmioCreateChunk establece la marca MMIO_DIRTY en dwFlags.

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 mmiscapi.h (include Mmiscapi.h, Windows.h)
Library Winmm.lib
Archivo DLL Winmm.dll