fonction waveOutSetPlaybackRate (mmeapi.h)
La fonction waveOutSetPlaybackRate définit la vitesse de lecture pour le périphérique de sortie audio de forme d’onde spécifié.
Syntaxe
MMRESULT waveOutSetPlaybackRate(
HWAVEOUT hwo,
DWORD dwRate
);
Paramètres
hwo
Gérez le périphérique de sortie audio de forme d’onde.
dwRate
Nouveau paramètre de débit de lecture. Ce paramètre est un multiplicateur indiquant la modification actuelle du taux de lecture par le 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 élevé contient la partie entière signée du nombre, et le mot d’ordre inférieur contient la partie fractionnaire. Une valeur de 0x8000 dans le mot de bas ordre représente la moitié et 0x4000 représente le quart. Par exemple, la valeur 0x00010000 spécifie un multiplicateur de 1.0 (aucune modification du 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 |
|---|---|
|
Le handle d’appareil spécifié n’est pas valide. |
|
Aucun pilote de périphérique n’est présent. |
|
Impossible d’allouer ou de verrouiller la mémoire. |
|
La fonction n’est pas prise en charge. |
Notes
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 débit de lecture. Pour déterminer si un appareil prend en charge les changements de débit de lecture, utilisez l’indicateur WAVECAPS_PLAYBACKRATE pour tester le membre dwSupport de la structure WAVEOUTCAPS (rempli par la fonction waveOutGetDevCaps ).
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 | mmeapi.h (inclure Windows.h) |
| Bibliothèque | Winmm.lib |
| DLL | Winmm.dll |