IDirectMusic8::CreateMusicBuffer
Warning: This technology is deprecated as is all of DirectMusic. Deprecated components are considered obsolete. While these components are still supported, they may be removed in the future. When writing new applications, you should avoid using these deprecated components. When modifying existing applications, you are strongly encouraged to remove any dependency on these components.
Deprecated.
The CreateMusicBuffer method creates a DirectMusicBuffer object to hold messages being sequenced to the port. Most applications do not need to call this method directly, because buffer management is handled by the performance when a port is added.
Syntax
HRESULT CreateMusicBuffer(
LPDMUS_BUFFERDESC pBufferDesc,
LPDIRECTMUSICBUFFER*..ppBuffer,
LPUNKNOWN pUnkOuter
);
Parameters
pBufferDesc
Address of the DMUS_BUFFERDESC structure that contains the description of the buffer to be created. The application must initialize the dwSize member of this structure before passing the pointer.
ppBuffer
Address of a variable that receives an IDirectMusicBuffer8 interface pointer.
pUnkOuter
Address of the controlling object's IUnknown interface for COM aggregation. Because aggregation is not currently supported, this value must be set to NULL.
Return Values
If the method succeeds, the return value is S_OK.
If it fails, the method can return one of the error values shown in the following table.
| Return code |
| CLASS_E_NOAGGREGATION |
| E_INVALIDARG |
| E_NOINTERFACE |
| E_OUTOFMEMORY |
| E_POINTER |
Requirements
** Minimum Supported Client:** Windows 2000.
** Minimum Supported Server:** Windows 2000 Server.
** Header:** Dmusicc.h
Library: Dmusic.dll
See Also