Share via

Função mmioCreateChunk (mmiscapi.h)

  • Artigo

A função mmioCreateChunk cria uma parte em um arquivo RIFF que foi aberto usando a função mmioOpen . A nova parte é criada na posição atual do arquivo. Depois que a nova parte é criada, a posição do arquivo atual é o início da parte de dados da nova parte.

Sintaxe

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

Parâmetros

hmmio

Identificador de arquivo de um arquivo RIFF aberto.

pmmcki

Ponteiro para um buffer que recebe uma estrutura MMCKINFO que contém informações sobre a parte a ser criada.

fuCreate

Sinalizadores que identificam que tipo de parte criar. Os valores a seguir são definidos.

Valor Significado
MMIO_CREATELIST Parte "LISTA".
MMIO_CREATERIFF Parte "RIFF".

Retornar valor

Retorna MMSYSERR_NOERROR se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.

Código de retorno Descrição
MMIOERR_CANNOTSEEK
 Não é possível determinar o deslocamento da parte de dados da parte.
MMIOERR_CANNOTWRITE
 Não é possível gravar o cabeçalho da parte.

Comentários

Essa função não pode inserir uma parte no meio de um arquivo. Se um aplicativo tentar criar uma parte em algum lugar diferente de no final de um arquivo, mmioCreateChunk substituirá as informações existentes no arquivo.

A estrutura MMCKINFO apontada pelo parâmetro lpck deve ser configurada da seguinte maneira:

  • O membro ckid especifica o identificador de parte. Se wFlags incluir MMIO_CREATERIFF ou MMIO_CREATELIST, esse membro será preenchido por mmioCreateChunk.
  • O membro cksize especifica o tamanho da parte de dados da parte, incluindo o tipo de formulário ou o tipo de lista (se houver). Se esse valor não estiver correto quando a função mmioAscend for chamada para marcar o fim da parte, mmioAscend corrigirá o tamanho da parte.
  • O membro fccType especifica o tipo de formulário ou o tipo de lista se a parte for uma parte "RIFF" ou "LIST". Se a parte não for uma parte "RIFF" ou "LIST", esse membro não precisará ser preenchido.
  • O membro dwDataOffset não precisa ser preenchido. A função mmioCreateChunk preenche esse membro com o deslocamento de arquivo da parte de dados da parte.
  • O membro dwFlags não precisa ser preenchido. A função mmioCreateChunk define o sinalizador MMIO_DIRTY em dwFlags.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mmiscapi.h (inclua Mmiscapi.h, Windows.h)
Biblioteca Winmm.lib
DLL Winmm.dll