acmStreamSize, fonction (msacm.h)

Article
08/24/2023

La fonction acmStreamSize retourne une taille recommandée pour une mémoire tampon source ou de destination sur un flux ACM.

Syntaxe

MMRESULT ACMAPI acmStreamSize(
  HACMSTREAM has,
  DWORD      cbInput,
  LPDWORD    pdwOutputBytes,
  DWORD      fdwSize
);

Paramètres

has

Gérez le flux de conversion.

cbInput

Taille, en octets, de la mémoire tampon source ou de destination. Les indicateurs fdwSize spécifient ce que le paramètre d’entrée définit. Ce paramètre doit être différent de zéro.

pdwOutputBytes

Pointeur vers une variable qui contient la taille, en octets, de la mémoire tampon source ou de destination. Les indicateurs fdwSize spécifient ce que le paramètre de sortie définit. Si la fonction acmStreamSize réussit, cet emplacement est toujours rempli avec une valeur différente de zéro.

fdwSize

Indicateurs pour la requête de taille de flux. Les valeurs suivantes sont définies :

Valeur	Signification
ACM_STREAMSIZEF_DESTINATION	Le paramètre cbInput contient la taille de la mémoire tampon de destination. Le paramètre pdwOutputBytes reçoit la taille de mémoire tampon source recommandée, en octets.
ACM_STREAMSIZEF_SOURCE	Le paramètre cbInput contient la taille de la mémoire tampon source. Le paramètre pdwOutputBytes reçoit la taille de mémoire tampon de destination recommandée, en octets.

Valeur retournée

Retourne zéro en cas de réussite ou une erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.

Code de retour	Description
ACMERR_NOTPOSSIBLE	Impossible d’effectuer l’opération demandée.
MMSYSERR_INVALFLAG	Au moins un indicateur n’est pas valide.
MMSYSERR_INVALHANDLE	Le handle spécifié n’est pas valide.
MMSYSERR_INVALPARAM	Au moins un paramètre n’est pas valide.

Remarques

Une application peut utiliser cette fonction pour déterminer les tailles de mémoire tampon suggérées pour les mémoires tampons source ou de destination. Les tailles de mémoire tampon retournées peuvent être uniquement une estimation des tailles réelles requises pour la conversion. Étant donné que les tailles de conversion réelles ne peuvent pas toujours être déterminées sans effectuer la conversion, les tailles retournées sont généralement surestimées.

En cas d’erreur, l’emplacement pointé par pdwOutputBytes reçoit zéro. Cela suppose que le pointeur spécifié par pdwOutputBytes est valide.

Configuration requise

Condition requise	Valeur
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

Voir aussi

Fonctions de compression audio

Gestionnaire de compression audio

Partager via