estructura KSDSOUND_BUFFERDESC (ksmedia.h)

Artículo
03/05/2024

La estructura KSDSOUND_BUFFERDESC describe un búfer de DirectSound.

Sintaxis

typedef struct {
  ULONG        Flags;
  ULONG        Control;
  WAVEFORMATEX WaveFormatEx;
} KSDSOUND_BUFFERDESC, *PKSDSOUND_BUFFERDESC;

Miembros

Flags

Especifica la configuración del búfer. Este miembro se puede establecer en el or bit a bit de uno o varios de los siguientes bits de marca:

KSDSOUND_BUFFER_PRIMARY

Indica que el búfer es un búfer de sonido principal (el búfer que el usuario escucha cuando se está jugando un juego).

KSDSOUND_BUFFER_STATIC

Indica que el búfer se usará para los datos de sonido estáticos.

KSDSOUND_BUFFER_LOCHARDWARE

Obliga al búfer a usar la combinación de hardware.

KSDSOUND_BUFFER_LOCSOFTWARE

Fuerza que el búfer se almacene en la memoria del sistema y use la combinación de software.

Control

Especifica las funcionalidades del búfer. Las funcionalidades de un búfer se representan mediante un conjunto de marcas de control. Este miembro se puede establecer en el or bit a bit de uno o varios de los siguientes bits de marca:

KSDSOUND_BUFFER_CTRL_3D

Indica que el búfer es un búfer principal o un búfer secundario con capacidad de control 3D. Si se establece este bit, el pin KS que representa el búfer implementa un nodo 3D (KSNODETYPE_3D_EFFECTS). Si se establece el bit de KSDSOUND_BUFFER_CTRL_HRTF_3D, el nodo 3D admite el conjunto de propiedades KSPROPSETID_Hrtf3d opcional.

KSDSOUND_BUFFER_CTRL_FREQUENCY

Indica que el búfer tiene capacidad de control de frecuencia. Si se establece este bit, el pin que representa el búfer implementa un nodo de conversión de velocidad de muestreo (KSNODETYPE_SRC).

KSDSOUND_BUFFER_CTRL_HRTF_3D

Indica que el búfer usa una función de transferencia relacionada con el encabezado (HRTF) para el control 3D. Si se establece este bit, también se debe establecer el bit de KSDSOUND_BUFFER_CTRL_3D.

KSDSOUND_BUFFER_CTRL_PAN

Indica que el búfer tiene capacidad de control panorámico. Si se establece este bit, la patilla que representa el búfer implementa un nodo de volumen (KSNODETYPE_VOLUME) para controlar el movimiento panorámico. Para obtener más información, consulte Requisitos de DirectSound Node-Ordering.

KSDSOUND_BUFFER_CTRL_VOLUME

Indica que el búfer tiene capacidad de control de volumen. Si se establece este bit, el pin que representa el búfer implementa un nodo de volumen (KSNODETYPE_VOLUME) para controlar el nivel de volumen de la secuencia.

KSDSOUND_BUFFER_CTRL_POSITIONNOTIFY

Indica que el búfer tiene funcionalidad de notificación de posición. Si se establece este bit, la patilla que representa el búfer admite la propiedad KSPROPERTY_AUDIO_POSITION .

WaveFormatEx

Especifica el formato de datos de onda del búfer. Este miembro es una estructura de tipo WAVEFORMATEX.

Comentarios

La estructura KSDATAFORMAT_DSOUND contiene un miembro BufferDesc que es una estructura KSDSOUND_BUFFERDESC.

Tenga en cuenta que el miembro WaveFormatEx de la estructura KSDSOUND_BUFFERDESC se puede extender para incluir información de formato adicional (por ejemplo, una máscara de configuración de canal). Para obtener más información, consulte WAVEFORMATEXTENSIBLE.