Structure ACMDRIVERDETAILS (msacm.h)
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 |
---|---|
|
Le pilote prend en charge les conversions asynchrones. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 |