struttura KSDSOUND_BUFFERDESC (ksmedia.h)

Articolo
08/07/2023

La struttura KSDSOUND_BUFFERDESC descrive un buffer DirectSound.

Sintassi

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

Members

Flags

Specifica la configurazione del buffer. Questo membro può essere impostato sull'OR bit per bit di uno o più dei bit di flag seguenti:

KSDSOUND_BUFFER_PRIMARY

Indica che il buffer è un buffer audio primario (il buffer che l'utente sente quando un gioco è in riproduzione).

KSDSOUND_BUFFER_STATIC

Indica che il buffer verrà usato per i dati audio statici.

KSDSOUND_BUFFER_LOCHARDWARE

Forza il buffer a usare la combinazione hardware.

KSDSOUND_BUFFER_LOCSOFTWARE

Forza l'archiviazione del buffer nella memoria di sistema e l'uso della combinazione di software.

Control

Specifica le funzionalità del buffer. Le funzionalità di un buffer sono rappresentate da un set di flag di controllo. Questo membro può essere impostato sull'OR bit per bit di uno o più dei bit di flag seguenti:

KSDSOUND_BUFFER_CTRL_3D

Indica che il buffer è un buffer primario o un buffer secondario con funzionalità di controllo 3D. Se questo bit è impostato, il pin KS che rappresenta il buffer implementa un nodo 3D (KSNODETYPE_3D_EFFECTS). Se il bit KSDSOUND_BUFFER_CTRL_HRTF_3D è impostato, il nodo 3D supporta il set di proprietà KSPROPSETID_Hrtf3d facoltativo.

KSDSOUND_BUFFER_CTRL_FREQUENCY

Indica che il buffer ha funzionalità di controllo della frequenza. Se questo bit è impostato, il pin che rappresenta il buffer implementa un nodo di conversione a frequenza di campionamento (KSNODETYPE_SRC).

KSDSOUND_BUFFER_CTRL_HRTF_3D

Indica che il buffer usa una funzione di trasferimento correlata alla testa (HRTF) per il controllo 3D. Se questo bit è impostato, è necessario impostare anche il bit KSDSOUND_BUFFER_CTRL_3D.

KSDSOUND_BUFFER_CTRL_PAN

Indica che il buffer ha funzionalità di controllo panoramica. Se questo bit è impostato, il pin che rappresenta il buffer implementa un nodo del volume (KSNODETYPE_VOLUME) per controllare la panoramica. Per altre informazioni, vedere Requisiti Node-Ordering DirectSound.

KSDSOUND_BUFFER_CTRL_VOLUME

Indica che il buffer ha funzionalità di controllo del volume. Se questo bit è impostato, il pin che rappresenta il buffer implementa un nodo del volume (KSNODETYPE_VOLUME) per controllare il livello del volume del flusso.

KSDSOUND_BUFFER_CTRL_POSITIONNOTIFY

Indica che il buffer dispone della funzionalità di notifica della posizione. Se questo bit è impostato, il pin che rappresenta il buffer supporta la proprietà KSPROPERTY_AUDIO_POSITION .

WaveFormatEx

Specifica il formato dei dati wave del buffer. Questo membro è una struttura di tipo WAVEFORMATEX.

Commenti

La struttura KSDATAFORMAT_DSOUND contiene un membro BufferDesc che è una struttura KSDSOUND_BUFFERDESC.

Si noti che il membro WaveFormatEx della struttura KSDSOUND_BUFFERDESC può essere esteso per includere informazioni di formato aggiuntive, ad esempio una maschera di configurazione del canale. Per informazioni dettagliate, vedere WAVEFORMATEXTENSIBLE.