estructura HDAUDIO_STREAM_FORMAT (hdaudio.h)

Artículo
02/26/2024

La estructura HDAUDIO_STREAM_FORMAT describe el formato de datos de una secuencia de captura o representación.

Sintaxis

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

Miembros

SampleRate

Especifica la frecuencia de muestreo en muestras por segundo. Este miembro indica la velocidad a la que se debe reproducir o grabar cada canal.

ValidBitsPerSample

Especifica el número de bits válidos por muestra. Los bits válidos se dejan justificados dentro del contenedor. Los bits sin usar a la derecha de los bits válidos deben establecerse en cero.

ContainerSize

Especifica el tamaño en bits de un contenedor de ejemplo. Los valores válidos para este miembro son 8, 16, 24 y 32.

NumberOfChannels

Especifica el número de canales de datos de audio. Para audio monofónico, establezca este miembro en 1. Para estéreo, establezca este miembro en 2.

Comentarios

Las rutinas AllocateCaptureDmaEngine, AllocateRenderDmaEngine y ChangeBandwidthAllocation toman como parámetro de entrada una estructura HDAUDIO_STREAM_FORMAT y generan la estructura de HDAUDIO_CONVERTER_FORMAT correspondiente. La información de un valor de HDAUDIO_STREAM_FORMAT válido se puede codificar como un valor de HDAUDIO_CONVERTER_FORMAT.

Esta estructura es similar a la estructura WAVEFORMATEXTENSIBLE , pero omite ciertos parámetros que están en WAVEFORMATEXTENSIBLE, pero no son relevantes para la tarea de administrar códecs conectados a un controlador de audio HD.