次の方法で共有


XAudio2Create

新しい XAudio2 オブジェクトを作成し、その IXAudio2 インターフェイスにポインターを返します。

HRESULT 
XAudio2Create(
  IXAudio2 **ppXAudio2,
  UINT32 Flags = 0,
  XAUDIO2_PROCESSOR XAudio2Processor = XAUDIO2_DEFAULT_PROCESSOR
);

パラメータ

  • ppXAudio2
    操作が成功した場合、IXAudio2 オブジェクトにポインターが返されます。

  • Flags
    XAudio2 オブジェクトの動作を指定するフラグです。このパラメーターの値には、0 または次に示す値を指定できます。

    説明
    XAUDIO2_DEBUG_ENGINE

    Windows:  デバッグ バージョンの XAudio2 ライブラリを要求します。

    Xbox 360:  効果なし。

  • XAudio2Processor
    使用する CPU を指定する列挙値。これらの値は、プラットフォームごとに意味が異なります。 特殊な XAUDIO2_DEFAULT_PROCESSOR の値を使用すると、XAudio2 は各プラットフォームで既定のプロセッサを使用できるようになります。

戻り値

正常に実行された場合は S_OK を返し、失敗した場合はエラー コードを返します。XAudio2 固有のエラー コードの説明については、「XAudio2 エラー コード」を参照してください。

解説 

Windows:  XAudio2Create は Windows で CoCreateInstance を呼び出すため、アプリケーションで CoInitializeEx メソッドを呼び出してから、XAudio2Create を呼び出す必要があります。さらに、COM のルールは、XAudio2 への呼び出しを実行するすべてのスレッドで CoInitialize または CoInitializeEx を呼び出す必要があります。

Xbox 360:  Xbox 360 は、XAUDIO2_MAX_INSTANCES より多い数の XAudio2 の同時インスタンスを持つことはできません。

要件

ヘッダー: Xaudio2.h 宣言

ライブラリ: Xaudio2.lib 内容

関連項目

XAudio2 の関数, 方法 : 基本的なオーディオ処理グラフの作成, 方法 : オーディオ デバイスの列挙