Structure ACMFORMATDETAILS (msacm.h)

Article
08/24/2023

La structure ACMFORMATDETAILS détaille un format audio de forme d’onde pour une balise de format spécifique pour un pilote ACM.

Syntaxe

typedef struct tACMFORMATDETAILS {
  DWORD          cbStruct;
  DWORD          dwFormatIndex;
  DWORD          dwFormatTag;
  DWORD          fdwSupport;
  LPWAVEFORMATEX pwfx;
  DWORD          cbwfx;
  char           szFormat[ACMFORMATDETAILS_FORMAT_CHARS];
} ACMFORMATDETAILS, *PACMFORMATDETAILS, *LPACMFORMATDETAILS;

Membres

cbStruct

Taille, en octets, de la structure ACMFORMATDETAILS . Ce membre doit être initialisé avant qu’une application appelle la fonction acmFormatDetails ou acmFormatEnum . La taille spécifiée par ce membre doit être suffisamment grande pour contenir la structure ACMFORMATDETAILS de base. Lorsque la fonction acmFormatDetails retourne, ce membre contient la taille réelle des informations retournées. Les informations retournées ne dépasseront jamais la taille demandée.

dwFormatIndex

Index du format pour lequel récupérer les détails. L’index est compris entre zéro et un de moins que le nombre de formats standard pris en charge par un pilote ACM pour une balise de format. Le nombre de formats standard pris en charge par un pilote pour une balise de format est contenu dans la structure ACMFORMATTAGDETAILS . Le membre dwFormatIndex est utilisé uniquement lorsqu’une application interroge des détails de format standard sur un pilote par index ; sinon, ce membre doit être égal à zéro. En outre, ce membre est défini sur zéro par le gestionnaire ACM lorsqu’une application demande des détails sur un format ; en d’autres termes, ce membre est utilisé uniquement pour l’entrée et n’est jamais retourné par aCM ou un pilote ACM.

dwFormatTag

Balise de format audio Waveform décrite par la structure ACMFORMATDETAILS . Ce membre est utilisé pour l’entrée pour l’indicateur de requête ACM_FORMATDETAILSF_INDEX. Pour l’indicateur de requête ACM_FORMATDETAILSF_FORMAT, ce membre doit être initialisé avec la même balise de format que celle spécifiée par le membre pwfx . Si un appel à la fonction acmFormatDetails 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.

fdwSupport

Indicateurs de prise en charge des pilotes spécifiques au format spécifié. Ces indicateurs sont identiques à la structure ACMDRIVERDETAILS . Ce membre peut être une combinaison des valeurs suivantes et indique les opérations que le pilote prend en charge pour 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 pour le format spécifié. Par exemple, si un pilote prend en charge la compression de WAVE_FORMAT_PCM vers WAVE_FORMAT_ADPCM avec le format spécifié, 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 tout en utilisant le format spécifié. Par exemple, si un pilote prend en charge le rééchantillonnage de WAVE_FORMAT_PCM au format spécifié, cet indicateur est défini.
ACMDRIVERDETAILS_SUPPORTF_FILTER	Le pilote prend en charge un filtre (qui modifie les données sans modifier les attributs de format) avec le format spécifié. 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 et/ou la sortie du format spécifié via un périphérique audio de forme d’onde. Une application doit utiliser acmMetrics avec les index ACM_METRIC_HARDWARE_WAVE_INPUT et ACM_METRIC_HARDWARE_WAVE_OUTPUT métriques pour obtenir les identificateurs de périphérique audio de forme d’onde associés au pilote ACM de prise en charge.

pwfx

Pointeur vers une structure WAVEFORMATEX qui recevra les détails du format. Cette structure ne nécessite aucune initialisation par l’application, sauf si l’indicateur ACM_FORMATDETAILSF_FORMAT est spécifié dans la fonction acmFormatDetails . Dans ce cas, le membre wFormatTag de la structure WAVEFORMATEX doit être égal au dwFormatTag de la structure ACMFORMATDETAILS .

cbwfx

Taille, en octets, disponible pour que pwfx reçoive les détails du format. Les fonctions acmMetrics et acmFormatTagDetails peuvent être utilisées pour déterminer la taille maximale requise pour n’importe quel format disponible pour le pilote spécifié (ou pour tous les pilotes ACM installés).

szFormat[ACMFORMATDETAILS_FORMAT_CHARS]

Chaîne qui décrit le format du type dwFormatTag . Si la fonction acmFormatDetails réussit, cette chaîne est toujours retournée.

Configuration requise

Condition requise	Valeur
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