IDirectMusicSynth::GetRunningStats, méthode (dmusics.h)
La GetRunningStats méthode récupère des informations actuelles sur l’état du synthétiseur afin qu’une application puisse indiquer comment le synthé effectue.
Syntaxe
HRESULT GetRunningStats(
LPDMUS_SYNTHSTATS pStats
);
Paramètres
pStats
Pointeur vers une structure DMUS_SYNTHSTATS (décrite dans Microsoft Windows SDK documentation). La méthode écrit les statistiques du synthèse dans cette structure.
Valeur retournée
GetRunningStats retourne S_OK si l’appel a réussi. Sinon, la méthode retourne un code d’erreur approprié. Le tableau suivant présente certains des codes d’état de retour possibles.
| Code de retour | Description |
|---|---|
|
Indique que la méthode n’est pas en mesure d’obtenir les statistiques. |
|
Indique un pointeur pStats incorrect. |
|
Indique que le synthétiseur n’a pas implémenté cette méthode (donc attendez-vous le pire!). |
|
Indique que le synthèse n’est pas ouvert ou non correctement configuré. |
Notes
La GetRunningStats méthode retourne des informations actuelles sur l’état du synthétiseur, notamment le chargement du processeur, le volume maximal et le nombre de notes volés (à partir de la modification des niveaux de priorité; voir IDirectMusicSynth::SetChannelPriority). La méthode génère ces statistiques dans une structure de DMUS_SYNTHSTATS.
Une application peut appeler GetRunningStats régulièrement pour obtenir l’état du synthétiseur au fur et à mesure qu’elle s’exécute. Tous les paramètres d’état en cours d’exécution, à l’exception de dwFreeMemory, sont actualisés toutes les secondes.
Une application accède GetRunningStats généralement indirectement en appelant IDirectMusicPort::GetRunningStats, qui est décrite dans la documentation du Kit de développement logiciel (SDK) Windows.
Configuration requise
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | dmusics.h (include Dmusics.h) |