Microsoft DirectX 8.0 (Visual Basic) |
プレーヤーまたはグループ用の 3D サウンド バッファを取得する。3D サウンド バッファ オブジェクトのメソッドを使用すると、指定したグループまたはプレーヤーから受信した音声転送の仮想 3D 位置を変更できる。
Create3DSoundBuffer(playerID As Long) _ As DirectSound3dBuffer8
Microsoft® DirectPlay® Voice のメイン バッファに使用される DirectSound3dBuffer8 型を返す。
失敗した場合は、Err.Number に次のいずれかの値が設定される。
DVERR_INVALIDPARAM |
DVERR_NOTCONNECTED |
DVERR_SESSIONLOST |
DVERR_ALREADYBUFFERED |
DVERR_INVALIDPOINTER |
DVERR_INVALIDOBJECT |
DVERR_NOTINITIALIZED |
DVERR_OUTOFMEMORY |
DVERR_NOTALLOWED |
DirectPlay Voice セッションがミキシング サーバー セッションの場合、このメソッドは失敗し、DVERR_NOTALLOWED を返す。
DirectPlay Voice クライアントはバッファを使用して受信オーディオのストリーミングを行うため、3D サウンド バッファ オブジェクトのすべてのメンバ関数にアクセスできる。ただし、DirectSound3Dbuffer オブジェクトの Lock、UnLock、Play の各メソッドは使用しないこと。
個々のユーザーのバッファが不必要になるか、プレーヤーが音声セッションを離れる場合、DirectPlayVoiceClient8.Delete3DSoundBuffer を呼び出し、リソースを解放する必要がある。