acmStreamSize, fonction (msacm.h)

  • Article

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