struttura KSDSOUND_BUFFERDESC (ksmedia.h)
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.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | ksmedia.h (include Ksmedia.h) |