fonction midiStreamProperty (mmeapi.h)

  • Article

La fonction midiStreamProperty définit ou récupère les propriétés d’un flux de données MIDI associé à un appareil de sortie MIDI.

Syntaxe

MMRESULT midiStreamProperty(
  HMIDISTRM hms,
  LPBYTE    lppropdata,
  DWORD     dwProperty
);

Paramètres

hms

Gérez l’appareil MIDI auquel la propriété est associée.

lppropdata

Pointeur vers les données de propriété.

dwProperty

Indicateurs qui spécifient l’action à effectuer et identifient la propriété appropriée du flux de données MIDI. La fonction midiStreamProperty nécessite la définition de deux indicateurs dans chaque utilisation. Un indicateur (MIDIPROP_GET ou MIDIPROP_SET) spécifie une action, et l’autre identifie une propriété spécifique à examiner ou à modifier.

Valeur Signification
MIDIPROP_GET Récupère le paramètre actuel de la propriété donnée.
MIDIPROP_SET Définit la propriété donnée.
MIDIPROP_TEMPO Récupère la propriété tempo. Le paramètre lppropdata pointe vers une structure MIDIPROPTEMPO . La valeur de tempo actuelle peut être récupérée à tout moment. Les périphériques de sortie définissent le tempo en insérant des événements MEVT_TEMPO dans les données MIDI.
MIDIPROP_TIMEDIV Spécifie la propriété de division de temps. Vous pouvez obtenir ou définir cette propriété. Le paramètre lppropdata pointe vers une structure MIDIPROPTIMEDIV . Cette propriété ne peut être définie que lorsque l’appareil est arrêté.

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 spécifié n’est pas un handle de flux.
MMSYSERR_INVALPARAM
 Le paramètre handle ou flags donné n’est pas valide.

Remarques

Ces propriétés sont les propriétés par défaut définies par le système. Les enregistreurs de pilotes peuvent implémenter et documenter leurs propres propriétés.

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 MIDI