KSDATARANGE_MUSIC構造体 (ksmedia.h)

[アーティクル]
02/07/2025

KSDATARANGE_MUSIC構造体は、DirectMusic MIDI 形式の範囲を指定します。

構文

typedef struct {
  KSDATARANGE DataRange;
  GUID        Technology;
  ULONG       Channels;
  ULONG       Notes;
  ULONG       ChannelMask;
} KSDATARANGE_MUSIC, *PKSDATARANGE_MUSIC;

メンバーズ

DataRange

DirectMusic データの MajorFormat GUID と SubFormat GUID、および指定子 GUID を指定します。このメンバーは、KSDATARANGE 構造体初期化されます。

Technology

MIDI 出力デバイスの種類を指定します。このメンバーには、次のいずれかの GUID を指定できます。

KSMUSIC_TECHNOLOGY_PORT

デバイスは MIDI ハードウェアポートです。

KSMUSIC_TECHNOLOGY_SYNTH

デバイスはシンセサイザーです。

KSMUSIC_TECHNOLOGY_SQSYNTH

デバイスは正方形のシンセサイザーです。

KSMUSIC_TECHNOLOGY_FMSYNTH

デバイスはFMシンセサイザーです。

KSMUSIC_TECHNOLOGY_MAPPER

デバイスは Microsoft MIDI マッパーです。

KSMUSIC_TECHNOLOGY_WAVETABLE

デバイスは、ハードウェアウェーブテーブルシンセサイザーです。

KSMUSIC_TECHNOLOGY_SWSYNTH

デバイスはソフトウェアシンセサイザーです。

Channels

内部シンセサイザーデバイスで再生できる同時チャネルの最大数を指定します。デバイスがポートの場合、このメンバーは意味を持たず、0 に設定されます。

Notes

内部シンセサイザーデバイスで再生できる同時ノートの最大数を指定します。デバイスがポートの場合、このメンバーは意味を持たず、0 に設定されます。

ChannelMask

内部シンセサイザーデバイスが応答するチャネルを指定します。最下位ビットはチャネル 0 を、最上位ビットはチャネル 15 を指します。すべてのチャネルで送信するポートデバイスは、このメンバーを0xFFFFに設定します。

備考

KSDATARANGE_MUSIC構造を使用するデータ範囲の例については、「MIDI ストリームデータ範囲のと DirectMusic Stream データ範囲を参照してください。

データ範囲と交差処理の詳細については、「Data-Intersection ハンドラーの」を参照してください。

必要条件

要件	価値
ヘッダー	ksmedia.h (Ksmedia.h を含む)

次の方法で共有