Structure ACMDRIVERDETAILS (msacm.h)

Article
08/24/2023

La structure ACMDRIVERDETAILS décrit les fonctionnalités d’un pilote ACM.

Syntaxe

typedef struct tACMDRIVERDETAILS {
  DWORD  cbStruct;
  FOURCC fccType;
  FOURCC fccComp;
  WORD   wMid;
  WORD   wPid;
  DWORD  vdwACM;
  DWORD  vdwDriver;
  DWORD  fdwSupport;
  DWORD  cFormatTags;
  DWORD  cFilterTags;
  HICON  hicon;
  char   szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS];
  char   szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS];
  char   szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS];
  char   szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS];
  char   szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS];
} ACMDRIVERDETAILS, *PACMDRIVERDETAILS, *LPACMDRIVERDETAILS;

Membres

cbStruct

Taille, en octets, des informations valides contenues dans la structure ACMDRIVERDETAILS . Une application doit initialiser ce membre à la taille, en octets, des informations souhaitées. La taille spécifiée dans ce membre doit être suffisamment grande pour contenir le membre cbStruct de la structure ACMDRIVERDETAILS . Lorsque la fonction acmDriverDetails retourne, ce membre contient la taille réelle des informations retournées. Les informations retournées ne dépasseront jamais la taille demandée.

fccType

Type du pilote. Pour les pilotes ACM, définissez ce membre sur ACMDRIVERDETAILS_FCCTYPE_AUDIOCODEC.

fccComp

Sous-type du pilote. Ce membre est actuellement défini sur ACMDRIVERDETAILS_FCCCOMP_UNDEFINED (zéro).

wMid

Identificateur du fabricant. Les identificateurs de fabricant sont définis dans Identificateurs de fabricant et de produit.

wPid

Identificateur de produit. Les identificateurs de produit sont définis dans Identificateurs de fabricant et de produit.

vdwACM

Version de l’ACM pour lequel ce pilote a été compilé. Le numéro de version est un nombre hexadécimal au format 0xAABBCCCC, où AA est le numéro de version principale, BB le numéro de version secondaire et CCCC le numéro de build. Les parties de version (principale, mineure et build) doivent être affichées sous forme de nombres décimaux.

vdwDriver

Version du pilote. Le numéro de version est un nombre hexadécimal au format 0xAABBCCCC, où AA est le numéro de version principale, BB le numéro de version secondaire et CCCC le numéro de build. Les parties de version (principale, mineure et build) doivent être affichées sous forme de nombres décimaux.

fdwSupport

Indicateurs de prise en charge pour le pilote. Les valeurs suivantes sont définies :

Nom	Description
ACMDRIVERDETAILS_SUPPORTF_ASYNC	Le pilote prend en charge les conversions asynchrones.
ACMDRIVERDETAILS_SUPPORTF_CODEC	Le pilote prend en charge la conversion entre deux balises de format différentes. Par exemple, si un pilote prend en charge la compression de WAVE_FORMAT_PCM en WAVE_FORMAT_ADPCM, cet indicateur est défini.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	Le pilote prend en charge la conversion entre deux formats différents de la même balise de format. Par exemple, si un pilote prend en charge le rééchantillonnage de WAVE_FORMAT_PCM, cet indicateur est défini.
ACMDRIVERDETAILS_SUPPORTF_DISABLED	Le pilote a été désactivé. Cet indicateur est défini par l’ACM pour un pilote lorsqu’il a été désactivé pour plusieurs raisons. Les pilotes désactivés ne peuvent pas être ouverts et ne peuvent être utilisés que dans des circonstances très limitées.
ACMDRIVERDETAILS_SUPPORTF_FILTER	Le pilote prend en charge un filtre (modification des données sans modifier les attributs de format). Par exemple, si un pilote prend en charge les opérations de volume ou d’écho sur WAVE_FORMAT_PCM, cet indicateur est défini.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	Le pilote prend en charge l’entrée matérielle, la sortie ou les deux via un périphérique audio de forme d’onde. Une application doit utiliser la fonction acmMetrics avec les index de métrique ACM_METRIC_HARDWARE_WAVE_INPUT et ACM_METRIC_HARDWARE_WAVE_OUTPUT pour obtenir les identificateurs de périphérique audio de forme d’onde associés au pilote ACM de prise en charge.
ACMDRIVERDETAILS_SUPPORTF_LOCAL	Le pilote a été installé localement par rapport à la tâche actuelle.

cFormatTags

Nombre de balises de format uniques prises en charge par ce pilote.

cFilterTags

Nombre de balises de filtre uniques prises en charge par ce pilote.

hicon

Gérez une icône personnalisée pour ce pilote. Une application peut utiliser cette icône pour référencer visuellement le pilote. Ce membre peut être NULL.

szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS]

Chaîne terminée par null qui décrit le nom du pilote. Cette chaîne est destinée à être affichée dans de petits espaces.

szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS]

Chaîne terminée par null qui décrit le nom complet du pilote. Cette chaîne est destinée à être affichée dans de grands espaces (descriptifs).

szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS]

Chaîne terminée par null qui fournit des informations de copyright pour le pilote.

szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS]

Chaîne terminée par null qui fournit des informations de licence spéciales pour le pilote.

szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS]

Chaîne terminée par null qui fournit des informations de fonctionnalités spéciales pour le pilote.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	msacm.h

Voir aussi

Gestionnaire de compression audio

Audio Compression Structures

acmDriverDetails

acmMetrics