Função mmioAscend (mmiscapi.h)

A função mmioAscend sobe de uma parte em um arquivo RIFF decrescente com a função mmioDescend ou criada com a função mmioCreateChunk .

Sintaxe

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

Parâmetros

hmmio

Identificador de arquivo de um arquivo RIFF aberto.

pmmcki

Ponteiro para uma estrutura MMCKINFO definida pelo aplicativo anteriormente preenchida pela função mmioDescend ou mmioCreateChunk .

fuAscend

Reservados; deve ser zero.

Retornar valor

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

Comentários

Se a parte foi decrescente usando mmioDescend, mmioAscend busca o local após o final da parte (após o byte extra do pad, se houver).

Se a parte foi criada e decrescente em usando mmioCreateChunk ou se o sinalizador MMIO_DIRTY for definido no membro dwFlags da estrutura MMCKINFO referenciada por lpck, a posição do arquivo atual será considerada o fim da parte de dados da parte. Se o tamanho da parte não for o mesmo que o valor armazenado no membro cksize da estrutura MMCKINFO quando mmioCreateChunk for chamado, mmioAscend corrigirá o tamanho da parte no arquivo antes de subir da parte. Se o tamanho da parte for ímpar, mmioAscend gravará um byte nulo no final da parte. Depois de ascender da parte, a posição do arquivo atual é o local após o final da parte (após o byte extra do pad, se houver).

Requisitos