funzione mmioAscend (mmiscapi.h)

Articolo
03/15/2023

La funzione mmioAscend aumenta fuori da un blocco in un file RIFF discendente con la funzione mmioDescend o creata con la funzione mmioCreateChunk .

Sintassi

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

Parametri

hmmio

Handle file di un file RIFF aperto.

pmmcki

Puntatore a una struttura MMCKINFO definita dall'applicazione compilata in precedenza dalla funzione mmioDescend o mmioCreateChunk .

fuAscend

Riservati; deve essere zero.

Valore restituito

Restituisce MMSYSERR_NOERROR se ha esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.

Codice restituito	Descrizione
MMIOERR_CANNOTSEEK	Si è verificato un errore durante la ricerca alla fine del blocco.
MMIOERR_CANNOTWRITE	Impossibile scrivere il contenuto del buffer sul disco.

Commenti

Se il blocco è stato discendente usando mmioDescend, mmioAscend cerca la posizione dopo la fine del blocco (passato il byte aggiuntivo, se presente).

Se il blocco è stato creato e discendente usando mmioCreateChunk oppure se il flag di MMIO_DIRTY è impostato nel membro dwFlags della struttura MMCKINFO a cui fa riferimento lpck, la posizione del file corrente viene considerata la fine della parte dati del blocco. Se le dimensioni del blocco non sono uguali al valore archiviato nel membro cksize della struttura MMCKINFO quando è stato chiamato mmioCreateChunk , mmioAscend corregge le dimensioni del blocco nel file prima di salire dal blocco. Se la dimensione del blocco è strana, mmioAscend scrive un byte di pad Null alla fine del blocco. Dopo aver crescente dal blocco, la posizione del file corrente è la posizione seguente alla fine del blocco (passato il byte del pad aggiuntivo, se presente).

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mmiscapi.h (includono Mmiscapi.h, Windows.h)
Libreria	Winmm.lib
DLL	Winmm.dll

Share via