Structure MIDIOUTCAPSA (mmeapi.h)

Article
11/20/2024

La structure MIDIOUTCAPS décrit les fonctionnalités d’un appareil de sortie MIDI.

Syntaxe

typedef struct tagMIDIOUTCAPSA {
  WORD      wMid;
  WORD      wPid;
  MMVERSION vDriverVersion;
  CHAR      szPname[MAXPNAMELEN];
  WORD      wTechnology;
  WORD      wVoices;
  WORD      wNotes;
  WORD      wChannelMask;
  DWORD     dwSupport;
} MIDIOUTCAPSA, *PMIDIOUTCAPSA, *NPMIDIOUTCAPSA, *LPMIDIOUTCAPSA;

Membres

wMid

Identificateur du fabricant du pilote de périphérique pour le périphérique de sortie MIDI. Les identificateurs de fabricant sont définis dans Fabricant et Identificateurs de produit.

wPid

Identificateur de produit de l’appareil de sortie MIDI. Les identificateurs de produit sont définis dans Fabricant et Identificateurs de produit.

vDriverVersion

Numéro de version du pilote de périphérique pour le périphérique de sortie MIDI. L’octet de commande élevée est le numéro de version principal, et l’octet de faible ordre est le numéro de version secondaire.

szPname[MAXPNAMELEN]

Nom du produit dans une chaîne terminée par null.

wTechnology

Type de l’appareil de sortie MIDI. Cette valeur peut être l’une des suivantes :

Nom	Description
MOD_MIDIPORT	Port matériel MIDI.
MOD_SYNTH	Synthétiseur.
MOD_SQSYNTH	Synthétiseur à onde carrée.
MOD_FMSYNTH	Synthétiseur FM.
MOD_MAPPER	Mappeur Microsoft MIDI.
MOD_WAVETABLE	Synthétiseur à ondes matérielles.
MOD_SWSYNTH	Synthétiseur logiciel.

wVoices

Nombre de voix prises en charge par un appareil de synthétiseur interne. Si l’appareil est un port, ce membre n’est pas significatif et est défini sur 0.

wNotes

Nombre maximal de notes simultanées pouvant être lues par un appareil de synthétiseur interne. Si l’appareil est un port, ce membre n’est pas significatif et est défini sur 0.

wChannelMask

Canaux auxquels un appareil de synthétiseur interne répond, où le bit le moins significatif fait référence au canal 0 et au bit le plus significatif au canal 15. Les appareils de port qui transmettent sur tous les canaux définissent ce membre sur 0xFFFF.

dwSupport

Fonctionnalités facultatives prises en charge par l’appareil. Il peut s’agir d’un ou plusieurs des éléments suivants :

Nom	Description
MIDICAPS_CACHE	Prend en charge la mise en cache des correctifs.
MIDICAPS_LRVOLUME	Prend en charge le contrôle de volume de gauche et de droite distinct.
MIDICAPS_STREAM	Fournit une prise en charge directe de la fonction midiStreamOut.
MIDICAPS_VOLUME	Prend en charge le contrôle de volume.

Si un appareil prend en charge les modifications de volume, l’indicateur de MIDICAPS_VOLUME est défini pour le membre dwSupport. Si un appareil prend en charge des modifications de volume distinctes sur les canaux de gauche et de droite, les MIDICAPS_VOLUME et les indicateurs de MIDICAPS_LRVOLUME sont définis pour ce membre.

Remarques

Note

L’en-tête mmeapi.h définit MIDIOUTCAPS comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
d’en-tête	mmeapi.h (include Windows.h)

Voir aussi

structures MIDI

Musical Instrument Digital Interface (MIDI)

midiStreamOut

Partager via