Microsoft DirectX 8.0 (C++)

DMUS_BUFFERDESC

IDirectMusic8::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 バイトとデータ サイズを合わせたサイズでなければならない。

動作環境

  ヘッダー : dmusici.h で宣言。

参照

DMUS_EVENTHEADERIDirectMusicBuffer8::PackStructuredIDirectMusicBuffer8::PackUnstructured