Fonction acmStreamUnprepareHeader (msacm.h)
La fonction acmStreamUnprepareHeader nettoie la préparation effectuée par la fonction acmStreamPrepareHeader pour un flux ACM. Cette fonction doit être appelée une fois l’ACM terminé avec les mémoires tampons données. Une application doit appeler cette fonction avant de libérer les mémoires tampons source et de destination.
Syntaxe
MMRESULT ACMAPI acmStreamUnprepareHeader(
HACMSTREAM has,
LPACMSTREAMHEADER pash,
DWORD fdwUnprepare
);
Paramètres
has
Gérer à la vapeur de conversion.
pash
Pointeur vers une structure ACMSTREAMHEADER qui identifie les mémoires tampons source et de destination à ne pas être préparées.
fdwUnprepare
Réservés au; doit être égal à zéro.
Valeur retournée
Retourne zéro en cas de réussite ou d’erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
L’en-tête de flux spécifié dans pash est en cours d’utilisation et ne peut pas être préparé. |
|
L’en-tête de flux spécifié dans pash n’est actuellement pas préparé par la fonction acmStreamPrepareHeader . |
|
Au moins un indicateur n’est pas valide. |
|
Le handle spécifié n’est pas valide. |
|
Au moins un paramètre n’est pas valide. |
Notes
La non-présentation d’un en-tête de flux qui n’a pas déjà été préparé est une erreur. Une application doit spécifier les longueurs de mémoire tampon source et de destination (cbSrcLength et cbDstLength, respectivement) qui ont été utilisées lors d’un appel à l’acmStreamPrepareHeader correspondant. Si vous ne réinitialisez pas ces valeurs membres , acmStreamUnprepareHeader échoue avec une erreur MMSYSERR_INVALPARAM.
L’ACM peut récupérer après certaines erreurs. L’ACM retourne une erreur différente de zéro, mais l’en-tête de flux n’est pas préparé correctement. Pour déterminer si l’en-tête de flux n’était pas préparé, une application peut examiner l’indicateur ACMSTREAMHEADER_STATUSF_PREPARED. Si acmStreamUnprepareHeader retourne la réussite, l’en-tête n’est toujours pas préparé.
Spécifications
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | msacm.h |
| Bibliothèque | Msacm32.lib |
| DLL | Msacm32.dll |