mmioSetBuffer-Funktion (mmiscapi.h)

  • Artikel

Die mmioSetBuffer-Funktion aktiviert oder deaktiviert gepufferte E/A oder ändert die Puffer- oder Puffergröße für eine datei, die mithilfe der mmioOpen-Funktion geöffnet wird.

Syntax

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

Parameter

hmmio

Dateihandle der Datei.

pchBuffer

Zeiger auf einen anwendungsdefinierten Puffer, der für gepufferte E/A-Vorgänge verwendet werden soll. Wenn dieser Parameter NULL ist, weist mmioSetBuffer einen internen Puffer für gepufferte E/A zu.

cchBuffer

Größe des vom Anwendung definierten Puffers in Zeichen oder die Größe des puffers für mmioSetBuffer , der zugeordnet werden soll.

fuBuffer

Reserviert; muss null sein.

Rückgabewert

Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler. Wenn ein Fehler auftritt, bleibt das Dateihandle gültig. Die folgenden Werte werden definiert.

Rückgabecode Beschreibung
MMIOERR_CANNOTWRITE
 Der Inhalt des alten Puffers konnte nicht auf den Datenträger geschrieben werden, sodass der Vorgang abgebrochen wurde.
MMIOERR_OUTOFMEMORY
 Der neue Puffer konnte nicht zugeordnet werden, wahrscheinlich aufgrund eines Mangels an verfügbarem Arbeitsspeicher.

Hinweise

Um das Puffern mithilfe eines internen Puffers zu aktivieren, legen Sie pchBuffer auf NULL und cchBuffer auf die gewünschte Puffergröße fest.

Wenn Sie Ihren eigenen Puffer bereitstellen möchten, legen Sie pchBuffer so fest, dass er auf den Puffer zeigt, und legen Sie cchBuffer auf die Größe des Puffers fest.

Um gepufferte E/A zu deaktivieren, legen Sie pchBuffer auf NULL und cchBuffer auf Null fest.

Wenn gepufferte E/A bereits mithilfe eines internen Puffers aktiviert ist, können Sie den Puffer auf eine andere Größe umstellen, indem Sie pchBuffer auf NULL und cchBuffer auf die neue Puffergröße festlegen. Der Inhalt des Puffers kann nach der Größenänderung geändert werden.

Anforderungen

   
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 (einschließlich Mmiscapi.h, Windows.h)
Bibliothek Winmm.lib
DLL Winmm.dll