fonction mmioSetBuffer (mmiscapi.h)

  • Article

La fonction mmioSetBuffer active ou désactive les E/S mises en mémoire tampon, ou modifie la taille de la mémoire tampon ou de la mémoire tampon d’un fichier ouvert à l’aide de la fonction mmioOpen .

Syntaxe

MMRESULT mmioSetBuffer(
  HMMIO hmmio,
  LPSTR pchBuffer,
  LONG  cchBuffer,
  UINT  fuBuffer
);

Paramètres

hmmio

Handle de fichier du fichier.

pchBuffer

Pointeur vers une mémoire tampon définie par l’application à utiliser pour les E/S mises en mémoire tampon. Si ce paramètre a la valeur NULL, mmioSetBuffer alloue une mémoire tampon interne pour les E/S mises en mémoire tampon.

cchBuffer

Taille, en caractères, de la mémoire tampon définie par l’application ou de la taille de la mémoire tampon pour mmioSetBuffer à allouer.

fuBuffer

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

Valeur retournée

Retourne zéro en cas de réussite ou une erreur dans le cas contraire. Si une erreur se produit, le handle de fichier reste valide. Les valeurs suivantes sont définies.

Code de retour Description
MMIOERR_CANNOTWRITE
 Le contenu de l’ancienne mémoire tampon n’a pas pu être écrit sur le disque, de sorte que l’opération a été abandonnée.
MMIOERR_OUTOFMEMORY
 La nouvelle mémoire tampon n’a pas pu être allouée, probablement en raison d’un manque de mémoire disponible.

Notes

Pour activer la mise en mémoire tampon à l’aide d’une mémoire tampon interne, définissez pchBuffer sur NULL et cchBuffer sur la taille de mémoire tampon souhaitée.

Pour fournir votre propre mémoire tampon, définissez pchBuffer pour qu’il pointe vers la mémoire tampon et définissez cchBuffer sur la taille de la mémoire tampon.

Pour désactiver les E/S mises en mémoire tampon, définissez pchBuffer sur NULL et cchBuffer sur zéro.

Si les E/S mises en mémoire tampon sont déjà activées à l’aide d’une mémoire tampon interne, vous pouvez réallouer la mémoire tampon à une autre taille en définissant pchBuffer sur NULL et cchBuffer sur la nouvelle taille de mémoire tampon. Le contenu de la mémoire tampon peut être modifié après le redimensionnement.

Spécifications

   
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