XAudio2Create 関数 (xaudio2.h)

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

構文

HRESULT XAudio2Create(
  [out] IXAudio2          **ppXAudio2,
  [in]  UINT32            Flags,
  [in]  XAUDIO2_PROCESSOR XAudio2Processor
);

[out] ppXAudio2

操作が成功した場合は、 IXAudio2 オブジェクトへのポインターを返します。

[in] Flags

IXAudio2 オブジェクトの動作を指定するフラグ。このパラメーターの値は 0 である必要があります。

[in] XAudio2Processor

使用する CPU を指定する XAUDIO2_PROCESSOR型指定の値。複数のビットが指定されている場合、システムはプロセッサごとに個別のワーカースレッドを作成します。

既定値XAUDIO2_PROCESSOR XAUDIO2_DEFAULT_PROCESSOR。

警告XAUDIO2_ANY_PROCESSORを指定した場合、システムはすべてのデバイスのプロセッサを使用し、前述のように、プロセッサごとにワーカースレッドを作成します。

メモプロセッサを指定することは、プロセッサ間でスレッドを効果的にスケジュールするスケジューラの機能に干渉する可能性があるため、通常は避ける必要があります。代わりに、XAUDIO2_DEFAULT_PROCESSOR値を渡します (以下を参照)。

特殊なXAUDIO2_DEFAULT_PROCESSOR値を指定すると、XAudio2 は既定のプロセッサを使用します。

成功した場合はS_OKを返し、それ以外の場合はエラーコードを返します。 XAudio2 固有のエラーコードの説明については、「XAudio2 エラーコード」を参照してください。

XAUDIO2の DirectX SDK バージョンでは、リリースと 'checked' バージョンの間で選択するフラグ XAUDIO2_DEBUG_ENGINE がサポートされました。このフラグは、XAUDIO2のWindows 8バージョンではサポートも定義もされていません。

メモ DirectX SDK には xaudio2.lib インポートライブラリが含まれているバージョンはありません。 DirectX SDK バージョンでは、COM を使用して新しい XAudio2 オブジェクトを作成します。

Windows 10 (XAudio2.9);Windows 8、Windows Phone 8 (XAudio 2.8);DirectX SDK (XAudio 2.7)

Windows Phone 8.1: この API がサポートされています。