Compartir a través de

Función mmioCreateChunk (mmiscapi.h)

  • Artículo

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 ejecuta correctamente o si se produce un error. Entre los posibles valores de error 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 centro de un archivo. Si una aplicación intenta crear un fragmento 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, mmioCreateChunk rellenará este miembro.
  • 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 tipo de lista si el fragmento es un fragmento "RIFF" o "LIST". Si el fragmento no es un fragmento "RIFF" o "LIST", no es necesario rellenar este miembro.
  • 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

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