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
ACMDRIVERDETAILS_SUPPORTF_ASYNC	Le pilote prend en charge les conversions asynchrones avec la balise de format spécifiée.
ACMDRIVERDETAILS_SUPPORTF_CODEC	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.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	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.
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 la balise de format spécifiée, cet indicateur est défini.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	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

Voir aussi

ACMDRIVERDETAILS

Gestionnaire de compression audio

Audio Compression Structures

acmFormatTagDetails

acmFormatTagEnum

acmMetrics