DirectSound DirectSound C/C++ 레퍼런스 DirectSound 의 구조체 DSBUFFERDESC   [목차열람] [주소복사] [슬롯비우기]

DSBUFFERDESC

DSBUFFERDESC 구조체는, 새로운 버퍼 개체의 특성을 기술한다. IDirectSound8::CreateSoundBuffer 메서드 및 DirectSoundFullDuplexCreate8 함수로 사용한다.

DirectX 7 이전과의 호환성을 유지하기 위해서(때문에), 이 구조체의 전의 버전인 DSBUFFERDESC1 도 dsound.h 로 유지되고 있다.

구문

typedef struct { 
  DWORD     dwSize; 
  DWORD     dwFlags; 
  DWORD     dwBufferBytes; 
  DWORD     dwReserved; 
  LPWAVEFORMATEX  lpwfxFormat; 
  GUID      guid3DAlgorithm; 
} DSBUFFERDESC, *LPDSBUFFERDESC; 
 
typedef const DSBUFFERDESC *LPCDSBUFFERDESC;

멤버

dwSize

구조체의 사이즈 (바이트 단위). 구조체를 사용하기 전에, 이 멤버를 초기화해야 한다.

dwFlags

버퍼의 능력을 나타내는 플래그. 다음의 값이 정의되고 있다.

dwBufferBytes

새로운 버퍼의 사이즈 (바이트 단위). DSBCAPS_PRIMARYBUFFER 플래그를 지정해 버퍼를 생성 하는 경우는, 이 값은 0 이 아니면 안된다. 2차 버퍼로 허용 되는 최소 사이즈와 최대 사이즈는, dsound.h 로 정의되고 있는 DSBSIZE_MIN 와 DSBSIZE_MAX 이다.

dwReserved

예약이 끝난 상태. 0 이 아니면 안된다.

lpwfxFormat

버퍼의 웨이브 폼 포맷을 지정하는 WAVEFORMATEX 구조체 또는 WAVEFORMATEXTENSIBLE 구조체의 주소. 1차 버퍼에서는, 이 값은 NULL 이어야 한다. 애플리케이션은 IDirectSoundBuffer8::SetFormat 를 사용해, 1차 버퍼의 포맷을 설정할 수 있다.

guid3DAlgorithm

DirectSound3D 의 하드웨어 에뮬레이션이 사용하는 2 스피커 가상화 알고리즘의 일의인 식별자. DSBCAPS_CTRL3D 가 dwFlags 로 설정되지 않은 경우, 이 멤버는 GUID_NULL (DS3DALG_DEFAULT)가 아니면 안된다.

다음의 알고리즘 식별자가 정의되고 있다.

주의

1차 버퍼를 생성 할 때는,dwBufferBytes 멤버에 0 을 설정해야 한다. 사용하고 있는 특정의 사운드 장치에 최적인 버퍼의 사이즈는, DirectSound 에 의해 결정된다. 생성 된 1차 버퍼의 사이즈를 얻어오려면,IDirectSoundBuffer8::GetCaps 를 호출한다.

DSBCAPS_CTRLDEFAULT 플래그는 지원하지 않는다. 이 플래그는, DSBCAPS_CTRLPAN | DSBCAPS_CTRLVOLUME | DSBCAPS_CTRLFREQUENCY 로서 정의되고 있었다. 필요한 플래그만을 지정하는 것으로써, 불필요한 리소스를 줄일 수가 있다.

VXD 드라이버의 경우, DSBCAPS_CTRLPOSITIONNOTIFY 를 사용해 생성 된 사운드 버퍼는 항상 소프트웨어 버퍼이다. 이것은, VXD 드라이버 모델이 통지를 지원 하지 않기 때문이다. WDM 드라이버에서는, 하드웨어 리소스가 이용 가능한 경우는, 통지를 지원 하는 버퍼를 하드웨어에 둘 수가 있다.

DSBCAPS_LOCHARDWARE 플래그와 DSBCAPS_LOCSOFTWARE 플래그는 옵션이며, 서로 배타적이다. DSBCAPS_LOCHARDWARE 는, 강제적으로 버퍼를 하드웨어에 배치한다. 즉, 버퍼는 사운드 카드에 의해 믹싱 된다. DSBCAPS_LOCSOFTWARE 는, 강제적으로 버퍼를 소프트웨어에 배치한다. 이 경우, 버퍼는 CPU 에 의해 믹싱 된다. 이러한 플래그는,DSBCAPS 구조체의 dwFlags 멤버에 대해서도 정의되고 있다.

3D 알고리즘은, 소프트웨어 에뮬레이션 계층만의 선택을 나타낸다. 즉, 가속화용의 하드웨어가 없는 경우에 사용되는 소프트웨어 알고리즘이다. 하드웨어의 이용을 최대로 하기 위해서(때문에), DS3DALG_NO_VIRTUALIZATION 는 특별한 경우로서 다루어진다. 3D 하드웨어 음성의 빈 곳을 이용할 수 없는 경우, 버퍼는 3D 컨트롤과 함께 2D 버퍼로서 다루어진다. 특히, 사운드 버퍼를 DS3DALG_NO_VIRTUALIZATION 로 생성 하는 경우, 또는 DSBPLAY_LOCDEFER 로 생성 된 버퍼를 재생하는 경우는, 다음의 순서에 따른다.

1. 이용 가능한 3D 하드웨어 음성이 있는 경우는, 그 3D 하드웨어 음성을 사용한다.
2. 이용할 수 있는 3D 하드웨어 음성에 빈 곳이 없고, 2D 하드웨어 음성을 이용할 수 있는 경우는, 그 2D 하드웨어 음성을 사용한다. 이것이 가능한 것은, DS3DALG_NO_VIRTUALIZATION 알고리즘이 단순한 스테레오 팬 알고리즘이니까이다.
3. 이용할 수 있는 2D 또는 3D 하드웨어 음성에 빈 곳이 없는 경우는, 음성은 DS3DALG_NO_VIRTUALIZATION 알고리즘을 사용해 소프트웨어로 재생된다.

DSSPEAKER_HEADPHONE 또는 DSSPEAKER_STEREO 이외의 스피커 구성이 유효한 경우, 처리는 2 스피커 구성에 대한 처리와 같이 행해진다.

버퍼를 HRTF 알고리즘의 어느쪽이든을 사용해 생성 해, HRTF 알고리즘이 시스템으로 이용 불가능한 경우는 (예를 들어, WDM 시스템이 아닌 경우), 정상 종료의 코드 DS_NO_VIRTUALIZATION 가 반환된다. 생성 된 사운드 버퍼는, 대신에 DS3DALG_NO_VIRTUALIZATION 를 사용한다. 이 때문에, 애플리케이션에서는,CreateSoundBuffer 의 호출시에 명시적으로 DS_OK 를 체크하는 것이 아니라,SUCCEEDED 매크로 또는 FAILED 매크로를 사용할 필요가 있다.

요건

  헤더:Dsound.h 로 선언.

참조

• DirectSound 의 버퍼
• 동적 음성 관리
• IDirectSound8::CreateSoundBuffer