mmioCreateChunk-Funktion (mmiscapi.h)

  • Artikel

Die mmioCreateChunk-Funktion erstellt einen Block in einer RIFF-Datei, die mit der mmioOpen-Funktion geöffnet wurde. Der neue Block wird an der aktuellen Dateiposition erstellt. Nachdem der neue Block erstellt wurde, ist die aktuelle Dateiposition der Anfang des Datenteils des neuen Blocks.

Syntax

MMRESULT mmioCreateChunk(
  HMMIO      hmmio,
  LPMMCKINFO pmmcki,
  UINT       fuCreate
);

Parameter

hmmio

Dateihandle einer geöffneten RIFF-Datei.

pmmcki

Zeiger auf einen Puffer, der eine MMCKINFO-Struktur empfängt, die Informationen zum zu erstellenden Block enthält.

fuCreate

Flags, die identifizieren, welche Art von Block erstellt werden soll. Die folgenden Werte werden definiert.

Wert Bedeutung
MMIO_CREATELIST "LIST"-Block.
MMIO_CREATERIFF Block "RIFF".

Rückgabewert

Gibt MMSYSERR_NOERROR zurück, wenn erfolgreich oder andernfalls ein Fehler aufgetreten ist. Mögliche Fehlerwerte sind:

Rückgabecode Beschreibung
MMIOERR_CANNOTSEEK
 Der Offset des Datenteils des Blocks kann nicht bestimmt werden.
MMIOERR_CANNOTWRITE
 Der Blockheader kann nicht geschrieben werden.

Hinweise

Diese Funktion kann keinen Block in die Mitte einer Datei einfügen. Wenn eine Anwendung versucht, einen Block an einer anderen Stelle als am Ende einer Datei zu erstellen, überschreibt mmioCreateChunk vorhandene Informationen in der Datei.

Die MMCKINFO-Struktur , auf die der lpck-Parameter verweist, sollte wie folgt eingerichtet werden:

  • Das ckid-Element gibt den Blockbezeichner an. Wenn wFlags MMIO_CREATERIFF oder MMIO_CREATELIST enthält, wird dieser Member mit mmioCreateChunk gefüllt.
  • Der cksize-Member gibt die Größe des Datenteils des Blocks an, einschließlich des Formulartyps oder Listentyps (falls vorhanden). Wenn dieser Wert nicht korrekt ist, wenn die mmioAscend-Funktion aufgerufen wird, um das Ende des Blocks zu markieren, korrigiert mmioAscend die Blockgröße.
  • Das fccType-Element gibt den Formulartyp oder Listentyp an, wenn der Block ein "RIFF" oder "LIST"-Block ist. Wenn der Block kein "RIFF" oder "LIST"-Block ist, muss dieser Member nicht ausgefüllt werden.
  • Das dwDataOffset-Element muss nicht ausgefüllt werden. Die mmioCreateChunk-Funktion füllt diesen Member mit dem Dateioffset des Datenteils des Chunks aus.
  • Der dwFlags-Member muss nicht ausgefüllt werden. Die mmioCreateChunk-Funktion legt das MMIO_DIRTY-Flag in dwFlags fest.

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