mmioFlush-Funktion (mmiscapi.h)

  • Artikel

Die mmioFlush-Funktion schreibt den E/A-Puffer einer Datei auf den Datenträger, wenn der Puffer in geschrieben wurde.

Syntax

MMRESULT mmioFlush(
  HMMIO hmmio,
  UINT  fuFlush
);

Parameter

hmmio

Dateihandle einer Datei, die mit der mmioOpen-Funktion geöffnet wurde.

fuFlush

Flag, das bestimmt, wie die Leerung ausgeführt wird. Dies kann null oder folgendes sein.

Wert BESCHREIBUNG
MMIO_EMPTYBUF Leert den Puffer, nachdem er auf den Datenträger geschrieben wurde.

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt. Mögliche Fehlerwerte sind:

Rückgabecode Beschreibung
MMIOERR_CANNOTWRITE
 Der Inhalt des Puffers konnte nicht auf den Datenträger geschrieben werden.

Hinweise

Wenn Sie eine Datei mit der mmioClose-Funktion schließen, wird ihr Puffer automatisch geleert.

Wenn nicht genügend Speicherplatz zum Schreiben des Puffers vorhanden ist, schlägt mmioFlush fehl, auch wenn die vorherigen Aufrufe der mmioWrite-Funktion erfolgreich waren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mmiscapi.h (include Mmiscapi.h, Windows.h)
Bibliothek Winmm.lib
DLL Winmm.dll