Partager via


fonction midiOutGetDevCaps (mmeapi.h)

La fonction midiOutGetDevCaps interroge un appareil de sortie MIDI spécifié pour déterminer ses capacités.

Syntaxe

MMRESULT midiOutGetDevCaps(
  UINT          uDeviceID,
  LPMIDIOUTCAPS pmoc,
  UINT          cbmoc
);

Paramètres

uDeviceID

Identificateur de l’appareil de sortie MIDI. L’identificateur d’appareil spécifié par ce paramètre varie de zéro à un inférieur au nombre d’appareils présents. La constante MIDI_MAPPER est également un identificateur d’appareil valide.

Ce paramètre peut également être un handle d’appareil de cast correct.

pmoc

Pointeur vers une structure MIDIOUTCAPS . Cette structure est remplie d’informations sur les fonctionnalités de l’appareil.

cbmoc

Taille, en octets, de la structure MIDIOUTCAPS . Seuls les octets cbMidiOutCaps (ou moins) d’informations sont copiés vers l’emplacement pointé par lpMidiOutCaps. Si cbMidiOutCaps est égal à zéro, rien n’est copié et la fonction retourne MMSYSERR_NOERROR.

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_BADDEVICEID
L’identificateur d’appareil spécifié est hors de portée.
MMSYSERR_INVALPARAM
Le pointeur ou la structure spécifiés n’est pas valide.
MMSYSERR_NODRIVER
Le pilote n’est pas installé.
MMSYSERR_NOMEM
Le système ne peut pas charger la description de chaîne du mappeur.

Notes

Pour déterminer le nombre d’appareils de sortie MIDI présents dans le système, utilisez la fonction midiOutGetNumDevs .

Configuration requise

   
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 MIDI