Structure ACMFORMATTAGDETAILS (msacm.h)
La structure ACMFORMATTAGDETAILS détaille une balise de format audio de forme d’onde pour un pilote ACM.
Syntaxe
typedef struct tACMFORMATTAGDETAILS {
DWORD cbStruct;
DWORD dwFormatTagIndex;
DWORD dwFormatTag;
DWORD cbFormatSize;
DWORD fdwSupport;
DWORD cStandardFormats;
char szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS];
} ACMFORMATTAGDETAILS, *PACMFORMATTAGDETAILS, *LPACMFORMATTAGDETAILS;
Membres
cbStruct
Taille, en octets, de la structure ACMFORMATTAGDETAILS . Ce membre doit être initialisé avant qu’une application appelle la fonction acmFormatTagDetails ou acmFormatTagEnum . La taille spécifiée par ce membre doit être suffisamment grande pour contenir la structure ACMFORMATTAGDETAILS de base. Lorsque la fonction acmFormatTagDetails retourne, ce membre contient la taille réelle des informations retournées. Les informations retournées ne dépasseront jamais la taille demandée.
dwFormatTagIndex
Index de la balise de format pour laquelle les détails seront récupérés. L’index est compris entre zéro et un de moins que le nombre de balises de format prises en charge par un pilote ACM. Le nombre de balises de format prises en charge par un pilote est contenu dans la structure ACMDRIVERDETAILS . Le membre dwFormatTagIndex est utilisé uniquement lors de l’interrogation des détails de la balise de format sur un pilote par index ; sinon, ce membre doit être égal à zéro.
dwFormatTag
Balise de format audio Waveform décrite par la structure ACMFORMATTAGDETAILS . Ce membre est utilisé pour l’entrée pour les indicateurs de requête ACM_FORMATTAGDETAILSF_FORMATTAG et ACM_FORMATTAGDETAILSF_LARGESTSIZE. Si la fonction acmFormatTagDetails réussit, ce membre est toujours retourné. Ce membre doit être défini sur WAVE_FORMAT_UNKNOWN pour tous les autres indicateurs de requête.
cbFormatSize
Taille totale la plus grande, en octets, d’un format audio de forme d’onde de type dwFormatTag . Par exemple, ce membre sera 16 pour WAVE_FORMAT_PCM et 50 pour WAVE_FORMAT_ADPCM.
fdwSupport
Indicateurs de prise en charge des pilotes spécifiques à la balise de format. Ces indicateurs sont identiques à la structure ACMDRIVERDETAILS . Ce membre peut être une combinaison des valeurs suivantes et faire référence aux opérations que le pilote prend en charge avec la balise de format :
| Nom | Description |
|---|---|
|
Le pilote prend en charge les conversions asynchrones avec la balise de format spécifiée. |
|
Le pilote prend en charge la conversion entre deux balises de format différentes où l’une des balises est la balise de format spécifiée. 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 balise de format spécifiée. Par exemple, si un pilote prend en charge le rééchantillonnage de WAVE_FORMAT_PCM, cet indicateur est défini. |
|
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 la balise de format spécifiée, cet indicateur est défini. |
|
Le pilote prend en charge l’entrée matérielle, la sortie ou les deux de la balise de format spécifiée 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. |
cStandardFormats
Nombre de formats standard du type dwFormatTag ; c’est-à-dire la combinaison de tous les taux d’échantillonnage, bits par échantillon, canaux, etc. Cette valeur peut spécifier tous les formats pris en charge par le pilote, mais pas nécessairement.
szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS]
Chaîne qui décrit le type dwFormatTag . Si la fonction acmFormatTagDetails réussit, cette chaîne est toujours retournée.
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] |
| En-tête | msacm.h |