midiInGetDevCapsW 関数 (mmeapi.h)

  • [アーティクル]

midiInGetDevCaps 関数は、指定された MIDI 入力デバイスの機能を決定します。

構文

MMRESULT midiInGetDevCapsW(
  UINT_PTR      uDeviceID,
  LPMIDIINCAPSW pmic,
  UINT          cbmic
);

パラメーター

uDeviceID

MIDI 入力デバイスの識別子。 デバイス識別子は、存在するデバイスの数より 0 から 1 未満に変化します。 このパラメーターは、デバイス ハンドルを適切にキャストすることもできます。

pmic

デバイスの機能に関する情報が入力された MIDIINCAPS 構造体へのポインター。

cbmic

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

戻り値

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

リターン コード 説明
MMSYSERR_BADDEVICEID
 指定されたデバイス識別子が範囲外です。
MMSYSERR_INVALPARAM
 指定されたポインターまたは構造体が無効です。
MMSYSERR_NODRIVER
 ドライバーがインストールされていません。
MMSYSERR_NOMEM
 システムはメモリを割り当てまたはロックできません。

解説

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

注意

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

要件

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

関連項目

MIDI 関数