mmioAscend-Funktion (mmiscapi.h)

  • Artikel

Die mmioAscend-Funktion steigt aus einem Block in einer RIFF-Datei auf, die mit der mmioDescend-Funktion absteigen oder mit der mmioCreateChunk-Funktion erstellt wurde.

Syntax

MMRESULT mmioAscend(
  HMMIO      hmmio,
  LPMMCKINFO pmmcki,
  UINT       fuAscend
);

Parameter

hmmio

Dateihandle einer geöffneten RIFF-Datei.

pmmcki

Zeiger auf eine anwendungsdefinierte MMCKINFO-Struktur , die zuvor von der Funktion mmioDescend oder mmioCreateChunk gefüllt wurde.

fuAscend

Reserviert; muss null sein.

Rückgabewert

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

Rückgabecode Beschreibung
MMIOERR_CANNOTSEEK
 Beim Suchen am Ende des Blöckes ist ein Fehler aufgetreten.
MMIOERR_CANNOTWRITE
 Der Inhalt des Puffers konnte nicht auf den Datenträger geschrieben werden.

Hinweise

Wenn der Brocken mithilfe von mmioDescend in absteigend wurde, sucht mmioAscend nach der Position nach dem Ende des Blöckes (nach dem zusätzlichen Padbyte, falls vorhanden).

Wenn der Block mithilfe von mmioCreateChunk erstellt und absteigend ausgeführt wurde oder das MMIO_DIRTY-Flag im dwFlags-Element der MMCKINFO-Struktur festgelegt ist, auf die von lpck verwiesen wird, wird angenommen, dass die aktuelle Dateiposition das Ende des Datenteils des Blöckes ist. Wenn die Blockgröße nicht mit dem Wert identisch ist, der im cksize-Element der MMCKINFO-Struktur gespeichert ist, wenn mmioCreateChunk aufgerufen wurde, korrigiert mmioAscend die Blöckegröße in der Datei, bevor sie vom Block aufsteigen. Wenn die Blockgröße ungerade ist, schreibt mmioAscend ein NULL-Padbyte am Ende des Blöckes. Nach dem Aufsteigen aus dem Block ist die aktuelle Dateiposition der Speicherort nach dem Ende des Blöckes (nach dem zusätzlichen Padbyte, falls vorhanden).

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