Partager via


fonction waveOutGetPitch (mmeapi.h)

La fonction waveOutGetPitch récupère le paramètre de pitch actuel pour le périphérique de sortie audio de forme d’onde spécifié.

Syntaxe

MMRESULT waveOutGetPitch(
  HWAVEOUT hwo,
  LPDWORD  pdwPitch
);

Paramètres

hwo

Gérez le périphérique de sortie audio de forme d’onde.

pdwPitch

Pointeur vers une variable à remplir avec le paramètre de multiplicateur de pas actuel. Le multiplicateur de pas indique le changement actuel de pitch par le paramètre créé d’origine. Le multiplicateur de pas doit être une valeur positive.

Le multiplicateur de pas est spécifié sous la forme d’une valeur à point fixe. Le mot d’ordre élevé de la variable 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 (aucun changement de pas), 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.

Notes

La modification du pitch ne modifie pas le taux de lecture, le taux d’échantillonnage ou le temps de lecture. Tous les appareils ne prennent pas en charge les changements de pitch. Pour déterminer si l’appareil prend en charge le contrôle pitch, utilisez l’indicateur WAVECAPS_PITCH 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

Voir aussi

Audio de forme d’onde

Fonctions de forme d’onde