mmioSetBuffer-Funktion (mmiscapi.h)

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.

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