XACT_RUNTIME_PARAMETERS

  • [アーティクル]

XACT エンジンの初期化に使用されるランタイム パラメーターの集まりです。

typedef struct XACT_RUNTIME_PARAMETERS {
    DWORD lookAheadTime;
    void *pGlobalSettingsBuffer;
    DWORD globalSettingsBufferSize;
    DWORD globalSettingsFlags;
    DWORD globalSettingsAllocAttributes;
    XACT_FILEIO_CALLBACKS fileIOCallbacks;
    XACT_NOTIFICATION_CALLBACK fnNotificationCallback;
    PWSTR pRendererID;
    IXAudio2 *pXAudio2;
    IXAudio2MasteringVoice *pMasteringVoice;
} XACT_RUNTIME_PARAMETERS, *LPXACT_RUNTIME_PARAMETERS;

typedef const XACT_RUNTIME_PARAMETERS *LPCXACT_RUNTIME_PARAMETERS;

メンバ

  • lookAheadTime
    インタラクティブ オーディオおよび分岐イベントのミリ秒単位の先読み時間です。別のサウンドにいつ移行するかを判定するときに、XACT エンジンがどの程度先読みするかを指定します。このメンバーには、既定値 XACT_ENGINE_LOOKAHEAD_DEFAULT を使用することをお勧めします。

  • pGlobalSettingsBuffer
    グローバル ファイル データを格納するバッファーです。このファイルは、XACT プロジェクト ファイルをビルドしたときに生成されます。カテゴリ、変数、および RPC 情報が含まれます。

  • Xbox 360: XACT_FLAG_API_CREATE_MANAGEDATA フラグを指定するときは、XMemAlloc を使用してこのメンバーのメモリーを割り当てる必要があります。

  • Windows: XACT_FLAG_API_CREATE_MANAGEDATA フラグを指定するときは、CoTaskMemAlloc を使用してこのメンバーのメモリーを割り当てる必要があります。

  • globalSettingsBufferSize
    pGlobalSettingsBuffer. に関連付けられたデータ バッファーのサイズです。

  • globalSettingsFlags
    XACT によってグローバル ファイル データが処理される方法を示すフラグです。このメンバーは、0 または次の表に示す値を指定できます。

    値 説明
    XACT_FLAG_API_CREATE_MANAGEDATA

    初期化の完了時に、XACT は pGlobalSettingsBuffer が指すバッファーを解放する必要があることを示します。

    注 バッファーの割り当てが失敗した場合、XACT はメモリーの解放を試みません。

    • globalSettingsAllocAttributes
      pGlobalSettingsBuffer が指すメモリー バッファーの属性を示すフラグ値です。

    • Xbox 360: このメンバーは、globalSettingsFlags に XACT_FLAG_API_CREATE_MANAGEDATA が指定された場合にのみ必要です。それにより、XACT がバッファーを解放する際に XMemFree は正しい値を受け取ることができます。それ以外の場合、globalSettingsAllocAttributes は無視されます。

    • pGlobalSettingsBuffer が指すメモリー バッファーが割り当てられた際に、XMemAlloc に指定された XALLOC_ATTRIBUTES にこれらのフラグが一致する必要があります。

    • Windows: このパラメーターは関係がないため、無視されます。

    • fileIOCallbacks
      ファイル I/O コールバックです。

    • fnNotificationCallback
      通知を受け取るコールバックです。

    • pRendererID
      エンジンが接続するオーディオ レンダラーの ID へのポインターです。

    • Xbox 360: このパラメーターは未定義です。

    • pXAudio2
      エンジンで使用する IXAudio2 インターフェイスへのポインターです。このメンバーが NULL の場合、XACT エンジンは XAudio2 オブジェクトを作成します。

    • pMasteringVoice
      XACT エンジンで使用するマスター ボイスを表す IXAudio2MasteringVoice インターフェイスへのポインターです。pXAudio2 が NULL の場合、このメンバーも必ず NULL になります。

    要件

    ヘッダー: Xact3.h 宣言

    関連項目

    XACT3 の構造体, IXACT3Engine::Initialize