Share via

funzione acmStreamUnprepareHeader (msacm.h)

  • Articolo

La funzione acmStreamUnprepareHeader pulisce la preparazione eseguita dalla funzione acmStreamPrepareHeader per un flusso ACM. Questa funzione deve essere chiamata dopo il completamento dell'ACM con i buffer specificati. Un'applicazione deve chiamare questa funzione prima di liberare i buffer di origine e di destinazione.

Sintassi

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

Parametri

has

Gestire il vapore di conversione.

pash

Puntatore a una struttura ACMSTREAMHEADER che identifica i buffer di origine e di destinazione da preparare.

fdwUnprepare

Riservati; deve essere zero.

Valore restituito

Restituisce zero se ha esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.

Codice restituito Descrizione
ACMERR_BUSY
 L'intestazione di flusso specificata in pash è attualmente in uso e non può essere impreparata.
ACMERR_UNPREPARED
 L'intestazione di flusso specificata in pash non è attualmente preparata dalla funzione acmStreamPrepareHeader .
MMSYSERR_INVALFLAG
 Almeno un flag non è valido.
MMSYSERR_INVALHANDLE
 L'handle specificato non è valido.
MMSYSERR_INVALPARAM
 Almeno un parametro non è valido.

Commenti

Unpreparing di un'intestazione di flusso già non preparato è un errore. Un'applicazione deve specificare rispettivamente le lunghezze del buffer di origine e di destinazione (cbSrcLength e cbDstLength) usate durante una chiamata al corrispondente acmStreamPrepareHeader. Se non si reimposta questi valori membro, acmStreamUnprepareHeader avrà esito negativo con un errore di MMSYSERR_INVALPARAM.

ACM può essere ripristinato da alcuni errori. L'ACM restituirà un errore diverso da zero, ma l'intestazione del flusso verrà correttamente annullata. Per determinare se l'intestazione di flusso è stata effettivamente non completata, un'applicazione può esaminare il flag di ACMSTREAMHEADER_STATUSF_PREPARED. Se acmStreamUnprepareHeader restituisce l'esito positivo, l'intestazione verrà sempre annullata.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione msacm.h
Libreria Msacm32.lib
DLL Msacm32.dll

Vedi anche

Funzioni di compressione audio

Gestione compressione audio