次の方法で共有

midiOutGetDevCapsW 関数 (mmeapi.h)

  • [アーティクル]

midiOutGetDevCaps 関数は、指定された MIDI 出力デバイスを照会してその機能を判断します。

構文

MMRESULT midiOutGetDevCapsW(
  UINT_PTR       uDeviceID,
  LPMIDIOUTCAPSW pmoc,
  UINT           cbmoc
);

パラメーター

uDeviceID

MIDI 出力デバイスの識別子。 このパラメーターで指定されたデバイス識別子は、0 から 1 までの範囲で、存在するデバイスの数より小さくなります。 MIDI_MAPPER定数は、有効なデバイス識別子でもあります。

このパラメーターは、適切にキャストされたデバイス ハンドルにすることもできます。

pmoc

MIDIOUTCAPS 構造体へのポインター。 この構造体には、デバイスの機能に関する情報が格納されます。

cbmoc

MIDIOUTCAPS 構造体のサイズ (バイト単位)。 cbMidiOutCaps バイト (以下) の情報の のみが、lpMidiOutCaps指す場所にコピーされます。 cbMidiOutCaps が 0 の場合、何もコピーされません。関数はMMSYSERR_NOERRORを返します。

戻り値

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

リターン コード 形容
MMSYSERR_BADDEVICEID
 指定されたデバイス識別子が範囲外です。
MMSYSERR_INVALPARAM
 指定されたポインターまたは構造体が無効です。
MMSYSERR_NODRIVER
 ドライバーがインストールされていません。
MMSYSERR_NOMEM
 マッパー文字列の説明を読み込むことができません。

備考

システムに存在する MIDI 出力デバイスの数を確認するには、midiOutGetNumDevs 関数を使用します。

手記

mmeapi.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして midiOutGetDevCaps を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー mmeapi.h (Windows.h を含む)
ライブラリ Winmm.lib
DLL Winmm.dll

関連項目

MIDI Functions