DMUS_BUFFERDESC

The DMUS_BUFFERDESC structure is used to describe a buffer for the IDirectMusic::CreateMusicBuffer method.

typedef struct _DMUS_BUFFERDESC {
    DWORD dwSize;
    DWORD dwFlags;
    GUID  guidBufferFormat;
    DWORD cbBuffer;
} DMUS_BUFFERDESC, *LPDMUS_BUFFERDESC;
 

Members

dwSize

The size of this structure, in bytes. This member must be initialized before the structure is used.

dwFlags

No flags are defined.

guidBufferFormat

Identifier of the KS format of the buffer. The value GUID_NULL represents KSDATAFORMAT_SUBTYPE_DIRECTMUSIC.

If guidBufferFormat represents a KS format other than KSDATAFORMAT_SUBTYPE_DIRECTMUSIC, the application must verify that the port playing back the data understands the specified format; if not, the buffer will be ignored. To find out if the port supports a specific KS format, use the IKsControl::KsProperty method.

cbBuffer

Minimum size of the buffer, in bytes. The amount of memory actually allocated may be slightly higher, as the system will pad the buffer to a multiple of four bytes. The buffer must be at least 32 bytes in order to accommodate a single MIDI channel message, and at least 28 bytes plus the size of the data in order to accommodate a sysex message or other unstructured data.

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dmusici.h.

See Also

DMUS_EVENTHEADER, IDirectMusicBuffer::PackStructured, IDirectMusicBuffer::PackUnstructured