estructura KSDSOUND_BUFFERDESC (ksmedia.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Header | ksmedia.h (incluya Ksmedia.h) |