fonction mmioAscend (mmiscapi.h)

  • Article

La fonction mmioAscend s’élève à partir d’un bloc dans un fichier RIFF descendu dans avec la fonction mmioDescend ou créé avec la fonction mmioCreateChunk .

Syntaxe

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

Paramètres

hmmio

Handle de fichier d’un fichier RIFF ouvert.

pmmcki

Pointeur vers une structure MMCKINFO définie par l’application précédemment remplie par la fonction mmioDescend ou mmioCreateChunk .

fuAscend

Réservés au; doit être égal à zéro.

Valeur retournée

Retourne MMSYSERR_NOERROR en cas de réussite ou une erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.

Code de retour Description
MMIOERR_CANNOTSEEK
 Une erreur s’est produite lors de la recherche jusqu’à la fin du bloc.
MMIOERR_CANNOTWRITE
 Le contenu de la mémoire tampon n’a pas pu être écrit sur le disque.

Remarques

Si le bloc a été descendu dans à l’aide de mmioDescend, mmioAscend recherche l’emplacement qui suit la fin du bloc (au-delà de l’octet de remplissage supplémentaire, le cas échéant).

Si le bloc a été créé et descendu à l’aide de mmioCreateChunk, ou si l’indicateur MMIO_DIRTY est défini dans le membre dwFlags de la structure MMCKINFO référencée par lpck, la position du fichier actuelle est supposée être la fin de la partie de données du bloc. Si la taille de bloc n’est pas la même que la valeur stockée dans le membre cksize de la structure MMCKINFO lors de l’appel de mmioCreateChunk , mmioAscend corrige la taille du bloc dans le fichier avant de monter à partir du bloc. Si la taille du bloc est impaire, mmioAscend écrit un octet de pad null à la fin du bloc. Une fois le bloc croissant, la position du fichier actuel est l’emplacement qui suit la fin du bloc (au-delà de l’octet de pavé supplémentaire, le cas échéant).

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête mmiscapi.h (inclure Mmiscapi.h, Windows.h)
Bibliothèque Winmm.lib
DLL Winmm.dll