mixerSetControlDetails, fonction (mmeapi.h)

Article
02/29/2024

La fonction mixerSetControlDetails définit les propriétés d’un seul contrôle associé à une ligne audio.

Syntaxe

MMRESULT mixerSetControlDetails(
  HMIXEROBJ             hmxobj,
  LPMIXERCONTROLDETAILS pmxcd,
  DWORD                 fdwDetails
);

Paramètres

hmxobj

Gérez l’objet d’appareil mixer pour lequel les propriétés sont définies.

pmxcd

Pointeur vers une structure MIXERCONTROLDETAILS . Cette structure est utilisée pour référencer des structures de détails de contrôle qui contiennent l’état souhaité pour le contrôle.

fdwDetails

Indicateurs permettant de définir les propriétés d’un contrôle. Les valeurs suivantes sont définies.

Valeur	Signification
MIXER_OBJECTF_AUX	Le paramètre hmxobj est un identificateur d’appareil auxiliaire compris entre zéro et un de moins que le nombre d’appareils retourné par la fonction auxGetNumDevs .
MIXER_OBJECTF_HMIDIIN	Le paramètre hmxobj est le handle d’un périphérique d’entrée MIDI. Ce handle doit avoir été retourné par la fonction midiInOpen .
MIXER_OBJECTF_HMIDIOUT	Le paramètre hmxobj est le handle d’un périphérique de sortie MIDI. Ce handle doit avoir été retourné par la fonction midiOutOpen .
MIXER_OBJECTF_HMIXER	Le paramètre hmxobj est une poignée de périphérique de mélangeur retournée par la fonction mixerOpen . Cet indicateur est facultatif.
MIXER_OBJECTF_HWAVEIN	Le paramètre hmxobj est un handle d’entrée audio de forme d’onde retourné par la fonction waveInOpen .
MIXER_OBJECTF_HWAVEOUT	Le paramètre hmxobj est un handle de sortie audio de forme d’onde retourné par la fonction waveOutOpen .
MIXER_OBJECTF_MIDIIN	Le paramètre hmxobj est l’identificateur d’un périphérique d’entrée MIDI. Cet identificateur doit être compris entre zéro et un de moins que le nombre d’appareils retournés par la fonction midiInGetNumDevs .
MIXER_OBJECTF_MIDIOUT	Le paramètre hmxobj est l’identificateur d’un périphérique de sortie MIDI. Cet identificateur doit être compris entre zéro et un de moins que le nombre d’appareils retournés par la fonction midiOutGetNumDevs .
MIXER_OBJECTF_MIXER	Le paramètre hmxobj est un identificateur d’appareil mixer compris entre zéro et un de moins que le nombre d’appareils retournés par la fonction mixerGetNumDevs . Cet indicateur est facultatif.
MIXER_OBJECTF_WAVEIN	Le paramètre hmxobj est l’identificateur d’un périphérique d’entrée audio de forme d’onde dans la plage de zéro à un de moins que le nombre d’appareils retournés par la fonction waveInGetNumDevs .
MIXER_OBJECTF_WAVEOUT	Le paramètre hmxobj est l’identificateur d’un appareil de sortie audio de forme d’onde dans la plage de zéro à un de moins que le nombre d’appareils retournés par la fonction waveOutGetNumDevs .
MIXER_SETCONTROLDETAILSF_CUSTOM	Une boîte de dialogue personnalisée pour le contrôle mixer personnalisé spécifié s’affiche. L’appareil mixer collecte les informations requises auprès de l’utilisateur et retourne les données dans la mémoire tampon spécifiée. Le handle de la fenêtre propriétaire est spécifié dans le membre hwndOwner de la structure MIXERCONTROLDETAILS . (Ce handle peut être défini sur NULL.) L’application peut ensuite enregistrer les données de la boîte de dialogue et l’utiliser ultérieurement pour réinitialiser le contrôle au même état à l’aide de l’indicateur MIXER_SETCONTROLDETAILSF_VALUE.
MIXER_SETCONTROLDETAILSF_VALUE	La ou les valeurs actuelles d’un contrôle sont définies. Le membre paDetails de la structure MIXERCONTROLDETAILS pointe vers une ou plusieurs structures de détails mixer-control de la classe appropriée pour le contrôle.

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
MIXERR_INVALCONTROL	La référence de contrôle n’est pas valide.
MMSYSERR_BADDEVICEID	Le paramètre hmxobj spécifie un identificateur d’appareil non valide.
MMSYSERR_INVALFLAG	Un ou plusieurs indicateurs ne sont pas valides.
MMSYSERR_INVALHANDLE	Le paramètre hmxobj spécifie un handle non valide.
MMSYSERR_INVALPARAM	Un ou plusieurs paramètres ne sont pas valides.
MMSYSERR_NODRIVER	Aucun dispositif de mixage n’est disponible pour l’objet spécifié par hmxobj.

Remarques

Tous les membres de la structure MIXERCONTROLDETAILS doivent être initialisés avant d’appeler mixerSetControlDetails.

Si une application doit récupérer uniquement l’état actuel d’un contrôle mixer personnalisé et ne pas afficher de boîte de dialogue, mixerGetControlDetails peut être utilisé avec l’indicateur MIXER_GETCONTROLDETAILSF_VALUE.

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

Fonctions de mixage audio

Mixeurs audio

Partager via