HDAUDIO_STREAM_FORMAT structure (hdaudio.h)

  • Article

La structure HDAUDIO_STREAM_FORMAT décrit le format de données d’un flux de capture ou de rendu.

Syntaxe

typedef struct _HDAUDIO_STREAM_FORMAT {
  ULONG  SampleRate;
  USHORT ValidBitsPerSample;
  USHORT ContainerSize;
  USHORT NumberOfChannels;
} HDAUDIO_STREAM_FORMAT, *PHDAUDIO_STREAM_FORMAT;

Membres

SampleRate

Spécifie le taux d’échantillonnage dans les échantillons par seconde. Ce membre indique la fréquence à laquelle chaque canal doit être lu ou enregistré.

ValidBitsPerSample

Spécifie le nombre de bits valides par échantillon. Les bits valides restent justifiés dans le conteneur. Tous les bits inutilisés à droite des bits valides doivent être définis sur zéro.

ContainerSize

Spécifie la taille en bits d’un exemple de conteneur. Les valeurs valides pour ce membre sont 8, 16, 24 et 32.

NumberOfChannels

Spécifie le nombre de canaux de données audio. Pour l’audio monophonique, définissez ce membre sur 1. Pour stéréo, définissez ce membre sur 2.

Remarques

Les routines AllocateCaptureDmaEngine, AllocateRenderDmaEngine et ChangeBandwidthAllocation prennent comme paramètre d’entrée une structure HDAUDIO_STREAM_FORMAT et génèrent la structure HDAUDIO_CONVERTER_FORMAT correspondante. Les informations d’une valeur HDAUDIO_STREAM_FORMAT valide peuvent être encodées en tant que valeur HDAUDIO_CONVERTER_FORMAT.

Cette structure est similaire à la structure WAVEFORMATEXTENSIBLE , mais elle omet certains paramètres qui sont dans WAVEFORMATEXTENSIBLE, mais qui ne sont pas pertinents pour la tâche de gestion des codecs connectés à un contrôleur Audio HD.

Configuration requise

Condition requise Valeur
En-tête hdaudio.h (inclure Hdaudio.h)

Voir aussi

AllocateCaptureDmaEngine

AllocateRenderDmaEngine

ChangeBandwidthAllocation

HDAUDIO_CONVERTER_FORMAT