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.

Código de retorno	Descrição
MMIOERR_CANNOTSEEK	Houve um erro ao tentar o fim da parte.
MMIOERR_CANNOTWRITE	O conteúdo do buffer não pôde ser gravado em disco.

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

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