Funzione mmioCreateChunk (mmiscapi.h)

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 restituito

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

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