Microsoft DirectX 8.1 (C++)

IDirectPlayVoiceClient::Delete3DSoundBuffer

Returns exclusive control of the 3-D sound buffer object to the Microsoft® DirectPlay® voice client object.

HRESULT Delete3DSoundBuffer(
DVID dvID
LPDIRECTSOUND3DBUFFER* lpUserBuffer
);

Parameters

dvID
[in] DVID of the player or group that the user wants to delete a buffer for.
lpUserBuffer
[in] Pointer to the user buffer to delete. This must be a user buffer obtained through the IDirectPlayVoiceClient::Create3DSoundBuffer method.

Return Values

Returns DV_OK if successful, or one of the following error values.

DVERR_ALREADYBUFFERED
DVERR_INVALIDOBJECT
DVERR_INVALIDPARAM
DVERR_INVALIDPOINTER
DVERR_NOTALLOWED
DVERR_NOTBUFFERED
DVERR_NOTCONNECTED
DVERR_NOTINITIALIZED
DVERR_SESSIONLOST

Remarks

If the DirectPlay Voice session is a mixing server session, this method fails and returns DVERR_NOTALLOWED.

Requirements

  Windows NT/2000/XP: Available as a redistributable for Windows 2000 and later.
  Windows 98/Me: Available as a redistributable for Windows 98 and later.
  Header: Declared in Dvoice.h.