funzione acmStreamUnprepareHeader (msacm.h)
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 |
|---|---|
|
L'intestazione di flusso specificata in pash è attualmente in uso e non può essere impreparata. |
|
L'intestazione di flusso specificata in pash non è attualmente preparata dalla funzione acmStreamPrepareHeader . |
|
Almeno un flag non è valido. |
|
L'handle specificato non è valido. |
|
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 |