fonction mmioCreateChunk (mmiscapi.h)

  • Article

La fonction mmioCreateChunk crée un bloc dans un fichier RIFF qui a été ouvert à l’aide de la fonction mmioOpen . Le nouveau bloc est créé à la position actuelle du fichier. Une fois le nouveau bloc créé, la position actuelle du fichier est le début de la partie données du nouveau bloc.

Syntaxe

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

Paramètres

hmmio

Handle de fichier d’un fichier RIFF ouvert.

pmmcki

Pointeur vers une mémoire tampon qui reçoit une structure MMCKINFO contenant des informations sur le bloc à créer.

fuCreate

Indicateurs identifiant le type de bloc à créer. Les valeurs suivantes sont définies.

Valeur Signification
MMIO_CREATELIST Bloc « LIST ».
MMIO_CREATERIFF Segment « RIFF ».

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
 Impossible de déterminer le décalage de la partie données du bloc.
MMIOERR_CANNOTWRITE
 Impossible d’écrire l’en-tête de bloc.

Remarques

Cette fonction ne peut pas insérer un bloc au milieu d’un fichier. Si une application tente de créer un bloc ailleurs qu’à la fin d’un fichier, mmioCreateChunk remplace les informations existantes dans le fichier.

La structure MMCKINFO pointée par le paramètre lpck doit être configurée comme suit :

  • Le membre ckid spécifie l’identificateur de bloc. Si wFlags inclut MMIO_CREATERIFF ou MMIO_CREATELIST, ce membre est rempli par mmioCreateChunk.
  • Le membre cksize spécifie la taille de la partie de données du bloc, y compris le type de formulaire ou le type de liste (le cas échéant). Si cette valeur n’est pas correcte lorsque la fonction mmioAscend est appelée pour marquer la fin du bloc, mmioAscend corrige la taille du bloc.
  • Le membre fccType spécifie le type de formulaire ou le type de liste si le bloc est un bloc « RIFF » ou « LIST ». Si le bloc n’est pas un bloc « RIFF » ou « LIST », ce membre n’a pas besoin d’être renseigné.
  • Le membre dwDataOffset n’a pas besoin d’être renseigné. La fonction mmioCreateChunk remplit ce membre avec le décalage de fichier de la partie de données du bloc.
  • Le membre dwFlags n’a pas besoin d’être renseigné. La fonction mmioCreateChunk définit l’indicateur MMIO_DIRTY dans dwFlags.

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