Microsoft DirectX 8.0 (Visual Basic)

DirectPlayVoiceClient8.Create3DSoundBuffer

プレーヤーまたはグループ用の 3D サウンド バッファを取得する。3D サウンド バッファ オブジェクトのメソッドを使用すると、指定したグループまたはプレーヤーから受信した音声転送の仮想 3D 位置を変更できる。

Create3DSoundBuffer(playerID As Long) _
    As DirectSound3dBuffer8

指定項目

playerID
ユーザーがバッファを保持する対象となるプレーヤーまたはグループの識別情報を指定する長整数型 (Long) の値。また、DVID_REMAINING を指定すると、ユーザー バッファがないすべてのプレーヤーまたはグループに対して 3D ユーザー バッファを作成できる。

戻り値

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 オブジェクトの LockUnLockPlay の各メソッドは使用しないこと。

個々のユーザーのバッファが不必要になるか、プレーヤーが音声セッションを離れる場合、DirectPlayVoiceClient8.Delete3DSoundBuffer を呼び出し、リソースを解放する必要がある。