Função acmStreamUnprepareHeader (msacm.h)

A função acmStreamUnprepareHeader limpa a preparação executada pela função acmStreamPrepareHeader para um fluxo do ACM. Essa função deve ser chamada depois que o ACM for concluído com os buffers fornecidos. Um aplicativo deve chamar essa função antes de liberar os buffers de origem e de destino.

Sintaxe

MMRESULT ACMAPI acmStreamUnprepareHeader(
  HACMSTREAM        has,
  LPACMSTREAMHEADER pash,
  DWORD             fdwUnprepare
);

Parâmetros

has

Manipule para o vapor de conversão.

pash

Ponteiro para uma estrutura ACMSTREAMHEADER que identifica os buffers de origem e destino a serem despreparados.

fdwUnprepare

Reservados; deve ser zero.

Valor retornado

Retornará zero se tiver êxito ou um erro, caso contrário. Os valores de erro possíveis incluem o seguinte.

Código de retorno	Descrição
ACMERR_BUSY	O cabeçalho de fluxo especificado no pash está atualmente em uso e não pode ser despreparado.
ACMERR_UNPREPARED	O cabeçalho de fluxo especificado no pash não está preparado atualmente pela função acmStreamPrepareHeader .
MMSYSERR_INVALFLAG	Pelo menos um sinalizador é inválido.
MMSYSERR_INVALHANDLE	O identificador especificado é inválido.
MMSYSERR_INVALPARAM	Pelo menos um parâmetro é inválido.

Comentários

Despreparar um cabeçalho de fluxo que já foi despreparado é um erro. Um aplicativo deve especificar os comprimentos de buffer de origem e destino (cbSrcLength e cbDstLength, respectivamente) que foram usados durante uma chamada para o acmStreamPrepareHeader correspondente. A falha ao redefinir esses valores de membro fará com que acmStreamUnprepareHeader falhe com um erro de MMSYSERR_INVALPARAM.

O ACM pode se recuperar de alguns erros. O ACM retornará um erro diferente de zero, mas o cabeçalho de fluxo será despreparado corretamente. Para determinar se o cabeçalho do fluxo foi realmente despreparado, um aplicativo pode examinar o sinalizador ACMSTREAMHEADER_STATUSF_PREPARED. Se acmStreamUnprepareHeader retornar êxito, o cabeçalho sempre será despreparado.

Requisitos

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	msacm.h
Biblioteca	Msacm32.lib
DLL	Msacm32.dll

Confira também

Funções de compactação de áudio

Gerenciador de Compactação de Áudio