acmMetrics, fonction (msacm.h)

Article
08/24/2023

La fonction acmMetrics retourne différentes métriques pour aCM ou les objets ACM associés.

Syntaxe

MMRESULT ACMAPI acmMetrics(
  HACMOBJ hao,
  UINT    uMetric,
  LPVOID  pMetric
);

Paramètres

hao

Gérez l’objet ACM pour interroger la métrique spécifiée dans uMetric. Pour certaines requêtes, ce paramètre peut être NULL.

uMetric

Index de métrique à retourner dans pMetric.

Valeur	Signification
ACM_METRIC_COUNT_CODECS	La valeur retournée est le nombre de pilotes globaux de compresseur ou de décompresseur ACM dans le système. Le paramètre hao doit être NULL pour cet index de métrique. Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD .
ACM_METRIC_COUNT_CONVERTERS	La valeur retournée est le nombre de pilotes de convertisseur ACM globaux dans le système. Le paramètre hao doit être NULL pour cet index de métrique. Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD .
ACM_METRIC_COUNT_DISABLED	La valeur retournée est le nombre total de pilotes ACM globaux désactivés (de tous les types de support) dans le système. Le paramètre hao doit être NULL pour cet index de métrique. Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD . La somme des indices de métrique ACM_METRIC_COUNT_DRIVERS et ACM_METRIC_COUNT_DISABLED correspond au nombre total de pilotes ACM installés à l’échelle mondiale.
ACM_METRIC_COUNT_DRIVERS	La valeur retournée est le nombre total de pilotes ACM globaux activés (de tous les types de support) dans le système. Le paramètre hao doit être NULL pour cet index de métrique. Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD .
ACM_METRIC_COUNT_FILTERS	La valeur retournée est le nombre de pilotes de filtre ACM globaux dans le système. Le paramètre hao doit être NULL pour cet index de métrique. Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD .
ACM_METRIC_COUNT_HARDWARE	La valeur retournée est le nombre de pilotes matériels ACM globaux dans le système. Le paramètre hao doit être NULL pour cet index de métrique. Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD .
ACM_METRIC_COUNT_LOCAL_CODECS	La valeur retournée est le nombre de pilotes de compresseur ACM locaux, de pilotes de décompresseur ACM ou des deux pour la tâche appelante. Le paramètre hao doit être NULL pour cet index de métrique. Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD .
ACM_METRIC_COUNT_LOCAL_CONVERTERS	La valeur retournée est le nombre de pilotes de convertisseur ACM locaux pour la tâche appelante. Le paramètre hao doit être NULL pour cet index de métrique. Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD .
ACM_METRIC_COUNT_LOCAL_DISABLED	La valeur retournée est le nombre total de pilotes ACM désactivés locaux, de tous types de prise en charge, pour la tâche appelante. Le paramètre hao doit être NULL pour cet index de métrique. Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD . La somme des indices de métrique ACM_METRIC_COUNT_LOCAL_DRIVERS et ACM_METRIC_COUNT_LOCAL_DISABLED correspond au nombre total de pilotes ACM installés localement.
ACM_METRIC_COUNT_LOCAL_DRIVERS	La valeur retournée est le nombre total de pilotes ACM locaux activés (de tous les types de support) pour la tâche appelante. Le paramètre hao doit être NULL pour cet index de métrique. Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD .
ACM_METRIC_COUNT_LOCAL_FILTERS	La valeur retournée est le nombre de pilotes de filtre ACM locaux pour la tâche appelante. Le paramètre hao doit être NULL pour cet index de métrique. Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD .
ACM_METRIC_DRIVER_PRIORITY	La valeur retournée est la priorité actuelle pour le pilote spécifié. Le paramètre hao doit être un identificateur de pilote ACM valide du type de données HACMDRIVERID . Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD .
ACM_METRIC_DRIVER_SUPPORT	La valeur retournée est les indicateurs fdwSupport pour le pilote spécifié. Le paramètre hao doit être un identificateur de pilote ACM valide du type de données HACMDRIVERID . Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD .
ACM_METRIC_HARDWARE_WAVE_INPUT	La valeur retournée est l’identificateur de périphérique d’entrée audio de forme d’onde associé au pilote spécifié. Le paramètre hao doit être un identificateur de pilote ACM valide du type de données HACMDRIVERID qui prend en charge l’indicateur ACMDRIVERDETAILS_SUPPORTF_HARDWARE. Si aucun périphérique d’entrée audio de forme d’onde n’est associé au pilote, MMSYSERR_NOTSUPPORTED est retourné. Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD .
ACM_METRIC_HARDWARE_WAVE_OUTPUT	La valeur retournée est l’identificateur de périphérique de sortie audio de forme d’onde associé au pilote spécifié. Le paramètre hao doit être un identificateur de pilote ACM valide du type de données HACMDRIVERID qui prend en charge l’indicateur ACMDRIVERDETAILS_SUPPORTF_HARDWARE. Si aucun périphérique de sortie audio de forme d’onde n’est associé au pilote, MMSYSERR_NOTSUPPORTED est retourné. Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD .
ACM_METRIC_MAX_SIZE_FILTER	La valeur retournée est la taille de la plus grande structure WAVEFILTER . Si hao a la valeur NULL, la valeur de retour est la plus grande structure WAVEFILTER dans le système. Si hao identifie un instance ouvert d’un pilote ACM du type de données HACMDRIVER ou un identificateur de pilote ACM du type de données HACMDRIVERID, la plus grande structure WAVEFILTER pour ce pilote est retournée. Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD . Cette métrique n’est pas autorisée pour un handle de flux ACM du type de données HACMSTREAM .
ACM_METRIC_MAX_SIZE_FORMAT	La valeur retournée est la taille de la plus grande structure WAVEFORMATEX . Si hao a la valeur NULL, la valeur de retour est la plus grande structure WAVEFORMATEX dans le système. Si hao identifie un instance ouvert d’un pilote ACM du type de données HACMDRIVER ou un identificateur de pilote ACM du type de données HACMDRIVERID, la plus grande structure WAVEFORMATEX pour ce pilote est retournée. Le paramètre pMetric doit pointer vers une mémoire tampon d’une taille égale à une valeur DWORD . Cette métrique n’est pas autorisée pour un handle de flux ACM du type de données HACMSTREAM .

pMetric

Pointeur vers la mémoire tampon pour recevoir les détails de la métrique. La définition exacte dépend de l’index uMetric .

Valeur retournée

Retourne zéro en cas de réussite ou une erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.

Code de retour	Description
ACMERR_NOTPOSSIBLE	L’index spécifié dans uMetric ne peut pas être retourné pour le hao spécifié.
MMSYSERR_INVALHANDLE	Le handle spécifié n’est pas valide.
MMSYSERR_INVALPARAM	Au moins un paramètre n’est pas valide.
MMSYSERR_NOTSUPPORTED	L’index spécifié dans uMetric n’est pas pris en charge.

Spécifications


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	msacm.h
Bibliothèque	Msacm32.lib
DLL	Msacm32.dll

Voir aussi

Fonctions de compression audio

Gestionnaire de compression audio

Partager via