^{DMUS_BUFFERDESC}

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

Syntax

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

Members

dwSize

Size of this structure, in bytes. This member must be initialized to sizeof(DMUS_BUFFERDESC) 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 is ignored. To find out whether the port supports a specific KS format, use the IKsControl::KsProperty method.

cbBuffer

Minimum size of the buffer, in bytes. The amount of memory allocated can be slightly higher because the system pads the buffer to a multiple of 4 bytes. The buffer must be at least 32 bytes to accommodate a single MIDI channel message, and at least 28 bytes plus the size of the data to accommodate a system exclusive message or other unstructured data.

Requirements

  Header: Declared in dmusici.h.

See Also

• DirectMusic Structures
• DMUS_EVENTHEADER
• IDirectMusicBuffer8::PackStructured
• IDirectMusicBuffer8::PackUnstructured