Platform SDK: DirectX

DMUS_BUFFERDESC

DMUS_BUFFERDESC 構造体は、IDirectMusic::CreateMusicBuffer メソッドのバッファを記述するために使われる。

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

メンバ

dwSize
構造体のサイズ。バイト単位で指定する。この構造体を使う前に、このメンバを初期化しなければならない。
dwFlags
フラグは定義されていない。
guidBufferFormat
バッファの KS フォーマットの識別子。値 GUID_NULL は、KSDATAFORMAT_SUBTYPE_DIRECTMUSIC を表す。

guidBufferFormat が KSDATAFORMAT_SUBTYPE_DIRECTMUSIC 以外の KS フォーマットを表す場合、アプリケーションは、データを再生しているポートが指定のフォーマットを理解しているかどうか検証しなければならない。そうしなかった場合、バッファは無視される。ポートが特定の KS フォーマットをサポートしているかどうか調べるには、IKsControl::KsProperty メソッドを使う。

cbBuffer
メッセージの最小サイズ (バイト単位)。システムがバッファを 4 バイトの倍数に追加するため、割り当てることのできるメモリ量はわずかに増える。1 つの MIDI チャンネル メッセージを格納するには、バッファは少なくとも 32 バイトなければならない。システム エクスクルーシブ メッセージまたはその他の非構造化データを格納するために、バッファは最低 28 バイトとデータ サイズを合わせたサイズでなければならない。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusici.h で宣言。

参照

DMUS_EVENTHEADERIDirectMusicBuffer::PackStructuredIDirectMusicBuffer::PackUnstructured