fonction midiStreamProperty (mmeapi.h)

Article
03/04/2024

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

Partager via