Partager via


structure _WAVEFORMATEX

La structure _WAVEFORMATEX définit le format des données audio de forme d’onde.

Syntaxe

typedef struct _tWAVEFORMATEX {
  WORD  wFormatTag;
  WORD  nChannels;
  DWORD nSamplesPerSec;
  DWORD nAvgBytesPerSec;
  WORD  nBlockAlign;
  WORD  wBitsPerSample;
  WORD  cbSize;
} _WAVEFORMATEX;

Membres

wFormatTag

Doit être défini sur un format ou des formats pris en charge par l’appareil. Notez que les versions précédentes de Windows Media Gestionnaire de périphériques recommandé d’utiliser WMDM_WAVE_FORMAT_ALL pour indiquer la prise en charge de tous les formats. Toutefois, cela n’est plus recommandé, car différents lecteurs multimédias interpréteront cela de différentes manières, et peu d’appareils peuvent vraiment lire n’importe quel format de fichier. Il est maintenant recommandé d’utiliser la valeur WMDM_ENUM_PROP_VALID_VALUES_ANY de l’énumération WMDM_ENUM_PROP_VALID_VALUES_FORM ou, mieux encore, de spécifier une plage de formats avec la structure WMDM_PROP_VALUES_RANGE .

nChannels

Nombre de canaux dans les données audio de forme d’onde. Les données monaurales utilisent un seul canal et les données stéréo utilisent deux canaux.

nSamplesPerSec

Taux d’échantillonnage, en échantillons par seconde (Hertz), auquel chaque canal doit être lu ou enregistré. Les valeurs courantes pour nSamplesPerSec sont 8,0 kilohertz (kHz), 11,025 kHz, 22,05 kHz et 44,1 kHz.

nAvgBytesPerSec

Débit moyen de transfert de données requis pour la balise de format, en octets par seconde. Les logiciels de lecture et d’enregistrement peuvent estimer les tailles de mémoire tampon à l’aide du membre nAvgBytesPerSec .

nBlockAlign

Alignement des blocs, en octets. L’alignement de blocs est l’unité atomique minimale de données pour le type de format wFormatTag . Les logiciels de lecture et d’enregistrement doivent traiter un multiple de nBlockAlign octets de données à la fois. Les données écrites et lues à partir d’un appareil doivent toujours commencer au début d’un bloc. Par exemple, il n’est pas possible de démarrer correctement la lecture des données PCM au milieu d’un exemple (autrement dit, sur une limite qui n’est pas alignée par bloc).

wBitsPerSample

Bits par exemple pour le type de format wFormatTag .

cbSize

Ce membre est ignoré.

Spécifications

Condition requise Valeur
En-tête
Wmdm.idl

Voir aussi

IMDSPDevice::GetFormatSupport

IMDSPStorage::CreateStorage

IMDSPStorage::GetAttributes

IWMDMDevice::GetFormatSupport

IWMDMOperation::GetObjectAttributes

IWMDMOperation::SetObjectAttributes

IWMDMStorage::GetAttributes

Structures