Funzione mmioCreateChunk (mmiscapi.h)

Articolo
03/13/2024

La funzione mmioCreateChunk crea un blocco in un file RIFF aperto usando la funzione mmioOpen . Il nuovo blocco viene creato nella posizione del file corrente. Dopo aver creato il nuovo blocco, la posizione del file corrente è l'inizio della parte di dati del nuovo blocco.

Sintassi

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

Parametri

hmmio

Handle di file di un file RIFF aperto.

pmmcki

Puntatore a un buffer che riceve una struttura MMCKINFO contenente informazioni sul blocco da creare.

fuCreate

Flag che identificano il tipo di blocco da creare. Vengono definiti i valori seguenti.

Valore	Significato
MMIO_CREATELIST	Blocco "LIST".
MMIO_CREATERIFF	Blocco "RIFF".

Valore restituito

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

Codice restituito	Descrizione
MMIOERR_CANNOTSEEK	Impossibile determinare l'offset della parte di dati del blocco.
MMIOERR_CANNOTWRITE	Impossibile scrivere l'intestazione del blocco.

Commenti

Questa funzione non può inserire un blocco al centro di un file. Se un'applicazione tenta di creare un blocco in un punto diverso dalla fine di un file, mmioCreateChunk sovrascrive le informazioni esistenti nel file.

La struttura MMCKINFO a cui punta il parametro lpck deve essere impostata come segue:

Il membro ckid specifica l'identificatore di blocco. Se wFlags include MMIO_CREATERIFF o MMIO_CREATELIST, questo membro verrà riempito da mmioCreateChunk.
Il membro cksize specifica le dimensioni della parte di dati del blocco, incluso il tipo di modulo o il tipo di elenco (se presente). Se questo valore non è corretto quando viene chiamata la funzione mmioAscend per contrassegnare la fine del blocco, mmioAscend corregge le dimensioni del blocco.
Il membro fccType specifica il tipo di modulo o di elenco se il blocco è un blocco "RIFF" o "LIST". Se il blocco non è un blocco "RIFF" o "LIST", questo membro non deve essere compilato.
Non è necessario compilare il membro dwDataOffset . La funzione mmioCreateChunk riempie questo membro con l'offset del file della parte di dati del blocco.
Il membro dwFlags non deve essere compilato. La funzione mmioCreateChunk imposta il flag MMIO_DIRTY in dwFlags.

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 (include Mmiscapi.h, Windows.h)
Libreria	Winmm.lib
DLL	Winmm.dll

Condividi tramite