midiStreamProperty 関数 (mmeapi.h)

  • [アーティクル]

midiStreamProperty 関数は、MIDI 出力デバイスに関連付けられている MIDI データ ストリームのプロパティを設定または取得します。

構文

MMRESULT midiStreamProperty(
  HMIDISTRM hms,
  LPBYTE    lppropdata,
  DWORD     dwProperty
);

パラメーター

hms

プロパティが関連付けられている MIDI デバイスを処理します。

lppropdata

プロパティ データへのポインター。

dwProperty

実行するアクションを指定し、MIDI データ ストリームの適切なプロパティを識別するフラグ。 midiStreamProperty 関数では、各用途で 2 つのフラグを設定する必要があります。 1 つのフラグ (MIDIPROP_GETまたはMIDIPROP_SET) はアクションを指定し、もう 1 つは検査または編集する特定のプロパティを識別します。

値 意味
MIDIPROP_GET 指定されたプロパティの現在の設定を取得します。
MIDIPROP_SET 指定したプロパティを設定します。
MIDIPROP_TEMPO テンポ プロパティを取得します。 lppropdata パラメーターは、MIDIPROPTEMPO 構造体を指します。 現在のテンポ値はいつでも取得できます。 出力デバイスは、MIDIデータにMEVT_TEMPOイベントを挿入してテンポを設定します。
MIDIPROP_TIMEDIV 時間除算プロパティを指定します。 このプロパティを取得または設定できます。 lppropdata パラメーターは、MIDIPROPTIMEDIV 構造体を指します。 このプロパティは、デバイスが停止している場合にのみ設定できます。

戻り値

成功した場合はMMSYSERR_NOERRORを返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。

リターン コード 説明
MMSYSERR_INVALHANDLE
 指定されたハンドルはストリーム ハンドルではありません。
MMSYSERR_INVALPARAM
 指定されたハンドルまたはフラグ パラメーターが無効です。

注釈

これらのプロパティは、システムによって定義される既定のプロパティです。 ドライバー ライターは、独自のプロパティを実装して文書化できます。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mmeapi.h (Windows.h を含む)
Library Winmm.lib
[DLL] Winmm.dll

こちらもご覧ください

MIDI 関数