SetEnableXAudioFlag

サウンドの再生にXAudio2を使用するかどうかを設定する

SetEnableXAudioFlag Flag

Flag : サウンドの再生に XAudio2 を使用するかどうかのフラグ
( TRUE:使用する FALSE:使用しない( デフォルト ) )

(プラグイン / モジュール : DxLibW)

解説

DXライブラリはデフォルトではサウンドの再生に DirectSound を使用していますが、
より高機能なサウンド再生機能である XAudio2 を使用したい場合はこの関数を DxLib_Init を呼び出す前に TRUE を渡して呼び出します。

尚、XAudio2 を使用した場合のメリットとデメリットは以下の通りです。

<メリット>

・3Dサウンド再生機能が使用できる。

( デフォルトの DirectSound を使用する場合は擬似3Dサウンド再生 )

・サウンドのリバーブエフェクト機能が使用できる。

<デメリット>

・CPU負荷が DirectSound よりも高い。

・環境によってはプログラムのデバッグ起動時に偶に数十秒PCがフリーズすることがある。

メリットとデメリットを踏まえると、使用するかどうかは以下の様に判断することになると思います。

「3Dのゲームを作成する場合は XAudio2 を使用して、2Dゲームを作成する場合はデフォルトの DirectSound を使用する。
また3Dゲームを作成する場合でもデバッグ起動時に偶にPCがフリーズする現象が発生する場合は、
サウンド関連の作業をする場合やリリース用ビルドを作成する場合以外では DirectSound を使用する。」


<注意>

前述の通り、この関数による設定の変更は DxLib_Init を呼ぶ前で使用した場合のみ効果がありますので注意してください。

戻り値:
  -1:エラー発生
  0:成功

情報

プラグイン / モジュールDxLibW
バージョン3.24f
作成日2026/04/12
著作者DxLib: Takumi Yamada / HSP binding: IronHSP Project
URLhttps://dxlib.xsrv.jp/
備考hspdxlib.as をインクルードして使用
タイプDxLib ゲームライブラリ
グループDxLib その他
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\hspdxlib.hs