WaveOutGetPlaybackRate, fonction (mmeapi.h)

  • Article

La fonction waveOutGetPlaybackRate récupère la vitesse de lecture actuelle pour le périphérique de sortie audio de forme d’onde spécifié.

Syntaxe

MMRESULT waveOutGetPlaybackRate(
  HWAVEOUT hwo,
  LPDWORD  pdwRate
);

Paramètres

hwo

Handle vers le périphérique de sortie audio de forme d’onde.

pdwRate

Pointeur vers une variable à remplir avec le taux de lecture actuel. Le paramètre de vitesse de lecture est un multiplicateur qui indique la modification actuelle de la vitesse de lecture à partir du paramètre créé d’origine. Le multiplicateur de taux de lecture doit être une valeur positive.

Le taux est spécifié sous la forme d’une valeur de point fixe. Le mot d’ordre supérieur de la variable contient la partie entière signée du nombre, et le mot d’ordre inférieur contient la partie fractionnaire. La valeur 0x8000 dans le mot d’ordre inférieur représente la moitié et 0x4000 représente un quart. Par exemple, la valeur 0x00010000 spécifie un multiplicateur de 1,0 (aucun changement de taux de lecture) et une valeur de 0x000F8000 spécifie un multiplicateur de 15,5.

Valeur retournée

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

Code de retour Description
MMSYSERR_INVALHANDLE
 Le handle d’appareil spécifié n’est pas valide.
MMSYSERR_NODRIVER
 Aucun pilote de périphérique n’est présent.
MMSYSERR_NOMEM
 Impossible d’allouer ou de verrouiller la mémoire.
MMSYSERR_NOTSUPPORTED
 La fonction n’est pas prise en charge.

Remarques

La modification du taux de lecture ne modifie pas le taux d’échantillonnage, mais modifie le temps de lecture. Tous les appareils ne prennent pas en charge les changements de taux de lecture. Pour déterminer si un appareil prend en charge les changements de taux de lecture, utilisez l’indicateur WAVECAPS_PLAYBACKRATE pour tester le membre dwSupport de la structure WAVEOUTCAPS (rempli par la fonction waveOutGetDevCaps ).

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 mmeapi.h (inclure Windows.h)
Bibliothèque Winmm.lib
DLL Winmm.dll

Voir aussi

Waveform Audio

Fonctions de forme d’onde