fonction mmioGetInfo (mmiscapi.h)

  • Article

La fonction mmioGetInfo récupère des informations sur un fichier ouvert à l’aide de la fonction mmioOpen . Ces informations permettent à l’application d’accéder directement à la mémoire tampon d’E/S, si le fichier est ouvert pour les E/S mises en mémoire tampon.

Syntaxe

MMRESULT mmioGetInfo(
  HMMIO      hmmio,
  LPMMIOINFO pmmioinfo,
  UINT       fuInfo
);

Paramètres

hmmio

Handle de fichier du fichier.

pmmioinfo

Pointeur vers une mémoire tampon qui reçoit une structure MMIOINFO que mmioGetInfo remplit avec des informations sur le fichier.

fuInfo

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

Valeur retournée

Retourne zéro en cas de réussite ou d’erreur dans le cas contraire.

Notes

Pour accéder directement à la mémoire tampon d’E/S d’un fichier ouvert pour les E/S mises en mémoire tampon, utilisez les membres suivants de la structure MMIOINFO remplie par mmioGetInfo :

  • Le membre pchNext pointe vers l’octet suivant dans la mémoire tampon qui peut être lu ou écrit. Lorsque vous lisez ou écrivez, incrémentez pchNext par le nombre d’octets lus ou écrits.
  • Le membre pchEndRead pointe vers 1 octet après le dernier octet valide dans la mémoire tampon qui peut être lu.
  • Le membre pchEndWrite pointe vers 1 octet après le dernier emplacement de la mémoire tampon qui peut être écrit.
Après avoir lu ou écrit dans la mémoire tampon et modifié pchNext, n’appelez aucune fonction d’E/S de fichier multimédia à l’exception de mmioAdvance tant que vous n’appelez pas la fonction mmioSetInfo . Appelez mmioSetInfo lorsque vous avez terminé d’accéder directement à la mémoire tampon.

Lorsque vous atteignez la fin de la mémoire tampon spécifiée par le membre pchEndRead ou pchEndWrite , appelez mmioAdvance pour remplir la mémoire tampon à partir du disque ou écrire la mémoire tampon sur le disque. La fonction mmioAdvance met à jour les membres pchNext, pchEndRead et pchEndWrite dans la structure MMIOINFO pour le fichier.

Avant d’appeler mmioAdvance ou mmioSetInfo pour vider une mémoire tampon sur le disque, définissez l’indicateur MMIO_DIRTY dans le membre dwFlags de la structure MMIOINFO pour le fichier. Sinon, la mémoire tampon n’est pas écrite sur le disque.

Ne décrémentez pas pchNext et ne modifiez pas les membres de la structure MMIOINFO autres que pchNext et dwFlags. Ne définissez pas d’indicateurs dans dwFlags , sauf MMIO_DIRTY.

Configuration requise

   
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