Función mmioAscend (mmiscapi.h)

La función mmioAscend asciende fuera de un fragmento de un archivo RIFF descendiente de con la función mmioDescend o creada con la función mmioCreateChunk .

Sintaxis

MMRESULT mmioAscend(
  HMMIO      hmmio,
  LPMMCKINFO pmmcki,
  UINT       fuAscend
);

Parámetros

hmmio

Identificador de archivo de un archivo RIFF abierto.

pmmcki

Puntero a una estructura MMCKINFO definida por la aplicación rellenada previamente por la función mmioDescend o mmioCreateChunk .

fuAscend

Reservados; debe ser cero.

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	Error al buscar al final del fragmento.
MMIOERR_CANNOTWRITE	El contenido del búfer no se pudo escribir en el disco.

Comentarios

Si el fragmento se descendió en mediante mmioDescend, mmioAscend busca la ubicación que sigue al final del fragmento (más allá del byte del panel adicional, si existe).

Si el fragmento se creó y descendió a mediante mmioCreateChunk, o si la marca de MMIO_DIRTY se establece en el miembro dwFlags de la estructura MMCKINFO a la que hace referencia lpck, se supone que la posición del archivo actual es el final de la parte de datos del fragmento. Si el tamaño del fragmento no es el mismo que el valor almacenado en el miembro cksize de la estructura MMCKINFO cuando se llamó a mmioCreateChunk , mmioAscend corrige el tamaño del fragmento en el archivo antes de subir del fragmento. Si el tamaño del fragmento es impar, mmioAscend escribe un byte de panel nulo al final del fragmento. Después de subir desde el fragmento, la posición del archivo actual es la ubicación que sigue al final del fragmento (más allá del byte del panel adicional, si existe).

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