fonction auxOutMessage (mmeapi.h)

Article
08/24/2023

La fonction auxOutMessage envoie un message au périphérique de sortie auxiliaire donné. Cette fonction effectue également la vérification des erreurs sur l’identificateur d’appareil transmis dans le cadre du message.

Syntaxe

MMRESULT auxOutMessage(
  UINT      uDeviceID,
  UINT      uMsg,
  DWORD_PTR dw1,
  DWORD_PTR dw2
);

Paramètres

uDeviceID

Identificateur du périphérique de sortie auxiliaire pour recevoir le message.

uMsg

Message à envoyer.

dw1

Paramètre message.

dw2

Paramètre message.

Valeur retournée

Retourne la valeur de retour du message.

Notes

Les DRV_QUERYDEVICEINTERFACE requêtes de message pour le nom de l’interface d’appareil d’un appareil waveIn, waveOut, midiIn, midiOut ou mixer .

Pour DRV_QUERYDEVICEINTERFACE, dwParam1 est un pointeur vers une mémoire tampon allouée à l’appelant dans laquelle la fonction écrit une chaîne Unicode terminée par null contenant le nom de l’interface de périphérique. Si l’appareil n’a pas d’interface d’appareil, la longueur de chaîne est égale à zéro.

Pour DRV_QUERYDEVICEINTERFACE, dwParam2 spécifie la taille de la mémoire tampon en octets. Il s’agit d’un paramètre d’entrée pour la fonction . L’appelant doit spécifier une taille supérieure ou égale à la taille de mémoire tampon récupérée par le message DRV_QUERYDEVICEINTERFACESIZE .

Le message DRV_QUERYDEVICEINTERFACE est pris en charge dans Windows Me et Windows 2000 et versions ultérieures. Ce message est valide uniquement pour les fonctions waveInMessage, waveOutMessage, midiInMessage, midiOutMessage et mixerMessage . Le système intercepte ce message et retourne la valeur appropriée sans envoyer le message au pilote de périphérique. Pour obtenir des informations générales sur les fonctions xxxMessage interceptées par le système, consultez Messages d’appareil interceptés par le système.

Les deux constantes de message suivantes sont utilisées ensemble pour obtenir des noms d’interface d’appareil :

DRV_QUERYDEVICEINTERFACESIZE
DRV_QUERYDEVICEINTERFACE

Le premier message obtient la taille en octets de la mémoire tampon nécessaire pour contenir la chaîne contenant le nom de l’interface de l’appareil. Le deuxième message récupère la chaîne de nom dans une mémoire tampon de la taille requise.

Pour plus d’informations, consultez Obtention d’un nom d’interface d’appareil.

Le DRV_QUERYDEVICEINTERFACESIZE message interroge la taille de la mémoire tampon requise pour contenir le nom de l’interface de périphérique.

Pour DRV_QUERYDEVICEINTERFACESIZE, dwParam1 est un pointeur vers la taille de la mémoire tampon. Ce paramètre pointe vers une variable ULONG dans laquelle la fonction écrit la taille de mémoire tampon requise en octets. La taille inclut l’espace de stockage pour la valeur null de fin de la chaîne de nom. La taille est égale à zéro si l’ID d’appareil identifie un appareil qui n’a pas d’interface d’appareil.

Pour DRV_QUERYDEVICEINTERFACESIZE, dwParam2 n’est pas utilisé. Définissez ce paramètre sur zéro.

Ce message est valide uniquement pour les fonctions waveInMessage, waveOutMessage, midiInMessage, midiOutMessage et mixerMessage . Le système intercepte ce message et retourne la valeur appropriée sans envoyer le message au pilote de périphérique. Pour obtenir des informations générales sur les fonctions xxxMessage interceptées par le système, consultez Messages d’appareil interceptés par le système.

La taille de la mémoire tampon récupérée par ce message est exprimée sous la forme d’un nombre d’octets. Il spécifie la taille de la mémoire tampon nécessaire pour contenir la chaîne Unicode terminée par null qui contient le nom de l’interface de périphérique. L’appelant alloue une mémoire tampon de la taille spécifiée et utilise le message DRV_QUERYDEVICEINTERFACE pour récupérer la chaîne de nom de l’interface de périphérique.

Pour plus d’informations, consultez Obtention d’un nom d’interface d’appareil.

Le DRV_QUERYDEVNODE message interroge le numéro de devnode attribué à l’appareil par le gestionnaire Plug-and-Play.

Pour DRV_QUERYDEVNODE, dwParam1 est un pointeur vers une variable DWORD allouée par l’appelant dans laquelle la fonction écrit le numéro de devnode. Si aucun devnode n’est affecté à l’appareil, la fonction définit cette variable sur zéro.

Pour DRV_QUERYDEVNODE, dwParam2 n’est pas utilisé. Définissez ce paramètre sur zéro.

Dans Windows 2000 et versions ultérieures, le message retourne toujours MMSYSERR_NOTSUPPORTED. Ce message est valide uniquement pour les fonctions waveInMessage, waveOutMessage, midiInMessage, midiOutMessage et mixerMessage . Le système intercepte ce message et retourne la valeur appropriée sans envoyer le message au pilote de périphérique. Pour obtenir des informations générales sur les fonctions xxxMessage interceptées par le système, consultez Messages d’appareil interceptés par le système.

Le DRV_QUERYMAPPABLE message demande si l’appareil spécifié peut être utilisé par un mappeur.

Pour DRV_QUERYMAPPABLE, dwParam1 n’est pas utilisé. Définissez ce paramètre sur zéro.

Pour DRV_QUERYMAPPABLE, dwParam2 n’est pas utilisé. Définissez ce paramètre sur zéro.

Ce message est valide uniquement pour les fonctions waveInMessage, waveOutMessage, midiInMessage, midiOutMessage, mixerMessage et auxOutMessage . Le système intercepte ce message et retourne la valeur appropriée sans envoyer le message au pilote de périphérique. Pour obtenir des informations générales sur les fonctions xxxMessage interceptées par le système, consultez Messages d’appareil interceptés par le système.

Lorsqu’un programme d’application ouvre un mappeur au lieu d’un périphérique audio spécifique, le système insère un mappeur entre l’application et les appareils disponibles. Le mappeur sélectionne un appareil approprié en mappant les exigences de l’application à l’un des appareils disponibles. Pour plus d’informations sur les mappeurs, consultez la documentation Microsoft Windows SDK.

Le DRVM_MAPPER_CONSOLEVOICECOM_GET message récupère l’ID d’appareil de l’appareil de communication vocale préféré.

Pour DRVM_MAPPER_CONSOLEVOICECOM_GET, dwParam1 est un pointeur vers l’ID d’appareil. Ce paramètre pointe vers une variable DWORD dans laquelle la fonction écrit l’ID d’appareil de l’appareil de communication vocale préféré actuel. La fonction écrit la valeur (-1) si aucun appareil disponible n’est éligible en tant qu’appareil de communication vocale préféré.

Pour DRVM_MAPPER_CONSOLEVOICECOM_GET, dwParam2 est un pointeur vers status indicateurs. Ce paramètre pointe vers une variable DWORD dans laquelle la fonction écrit les indicateurs status appareil. Un seul bit d’indicateur est actuellement défini : DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY.

Ce message est valide uniquement pour les fonctions waveInMessage et waveOutMessage . Lorsqu’un appelant appelle ces deux fonctions avec le message DRVM_MAPPER_CONSOLEVOICECOM_GET, l’appelant doit spécifier l’ID d’appareil comme WAVE_MAPPER, puis convertir cette valeur en type de handle approprié. Pour les fonctions waveInMessage, waveOutMessage, midiInMessage, midiOutMessage ou mixerMessage , l’appelant doit convertir l’ID de l’appareil en un handle de type HWAVEIN, HWAVEOUT, HMIDIIN, HMIDIOUT ou HMIXER, respectivement. Notez que si l’appelant fournit un handle valide au lieu d’un ID d’appareil pour ce paramètre, la fonction échoue et retourne le code d’erreur MMSYSERR_NOSUPPORT.

Le système intercepte ce message et retourne la valeur appropriée sans envoyer le message au pilote de périphérique. Pour obtenir des informations générales sur les fonctions xxxMessage interceptées par le système, consultez Messages d’appareil interceptés par le système.

Ce message permet de déterminer quel appareil est préféré spécifiquement pour les communications vocales, contrairement au message DRVM_MAPPER_PREFERRED_GET , qui détermine quel appareil est préféré pour toutes les autres fonctions audio.

Par exemple, l’appareil waveOut préféré pour les communications vocales peut être l’écouteur d’un casque, mais l’appareil waveOut préféré pour toutes les autres fonctions audio peut être un ensemble de haut-parleurs stéréo.

Lorsque le bit d’indicateur DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY est défini à l’emplacement DWORD pointé par dwParam2, les API waveIn et waveOut utilisent uniquement l’appareil de communication vocale préféré actuel et ne recherchent pas d’autres appareils disponibles si l’appareil préféré n’est pas disponible. L’indicateur qui est généré par l’appel waveInMessage ou waveOutMessage s’applique au périphérique de communication vocale préféré pour les API waveIn et waveOut , que l’appel soit effectué à waveInMessage ou waveOutMessage. Pour plus d’informations, consultez L’ID d’appareil préféré Voice-Communications.

Le DRVM_MAPPER_PREFERRED_GET message récupère l’ID de l’appareil audio préféré.

Pour DRVM_MAPPER_PREFERRED_GET, dwParam1 est un pointeur vers l’ID d’appareil. Ce paramètre pointe vers une variable DWORD dans laquelle la fonction écrit l’ID d’appareil de l’appareil préféré actuel. La fonction écrit la valeur (-1) si aucun appareil disponible n’est éligible en tant qu’appareil préféré.

Pour DRVM_MAPPER_PREFERRED_GET, dwParam2 est un pointeur vers status indicateurs. Ce paramètre pointe vers une variable DWORD dans laquelle la fonction écrit les indicateurs status appareil. Un seul bit d’indicateur est actuellement défini (pour les appels waveInMessage et waveOutMessage uniquement) : DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY.

Ce message est valide uniquement pour les fonctions waveInMessage, waveOutMessage et midiOutMessage . Lorsque l’appelant appelle ces fonctions avec le message DRVM_MAPPER_PREFERRED_GET, l’appelant doit d’abord spécifier l’ID d’appareil comme WAVE_MAPPER (pour waveInMessage ou waveOutMessage) ou MIDI_MAPPER (pour midiOutMessage), puis caster cette valeur en type de handle approprié. Pour les fonctions waveInMessage, waveOutMessage ou midiOutMessage , l’appelant doit convertir l’ID de l’appareil en un type de handle de type HWAVEIN, HWAVEOUT ou HMIDIOUT, respectivement. Notez que si l’appelant fournit un handle valide au lieu d’un ID d’appareil pour ce paramètre, la fonction échoue et retourne le code d’erreur MMSYSERR_NOSUPPORT.

Ce message permet de déterminer quel appareil est préféré pour les fonctions audio en général, contrairement au message DRVM_MAPPER_CONSOLEVOICECOM_GET , qui détermine quel appareil est préféré spécifiquement pour les communications vocales.

Lorsque le bit d’indicateur DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY est défini à l’emplacement DWORD pointé par dwParam2, les API waveIn et waveOut utilisent uniquement l’appareil préféré actuel et ne recherchent pas d’autres appareils disponibles si l’appareil préféré n’est pas disponible. Notez que la fonction midiOutMessage ne génère pas cet indicateur : l’API midiOut utilise toujours uniquement l’appareil préféré. L’indicateur généré par l’appel waveInMessage ou waveOutMessage s’applique à l’appareil préféré pour les API waveIn et waveOut , que l’appel soit effectué à waveInMessage ou waveOutMessage.

Les fonctions xxxMessage acceptent cette valeur à la place d’un handle d’appareil valide afin de permettre à une application de déterminer l’ID d’appareil par défaut sans avoir à ouvrir d’abord un appareil. Pour plus d’informations, consultez Accès à l’ID d’appareil préféré.

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

Waveform Audio

Fonctions de forme d’onde