midiInGetDevCaps 関数 (mmeapi.h)
midiInGetDevCaps 関数は、指定された MIDI 入力デバイスの機能を決定します。
構文
MMRESULT midiInGetDevCaps(
UINT uDeviceID,
LPMIDIINCAPS pmic,
UINT cbmic
);
パラメーター
uDeviceID
MIDI 入力デバイスの識別子。 デバイス識別子は、存在するデバイスの数よりも 0 から 1 未満に変化します。 このパラメーターは、適切にキャストされたデバイス ハンドルにすることもできます。
pmic
デバイスの機能に関する情報が入力された MIDIINCAPS 構造体へのポインター。
cbmic
MIDIINCAPS 構造体のサイズ (バイト単位)。 lpMidiInCaps が指す場所にコピーされるのは、cbMidiInCaps バイト (以下) の情報のみです。 cbMidiInCaps が 0 の場合、何もコピーされず、関数はMMSYSERR_NOERRORを返します。
戻り値
成功した場合はMMSYSERR_NOERRORを返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。
リターン コード | 説明 |
---|---|
|
指定されたデバイス識別子が範囲外です。 |
|
指定されたポインターまたは構造体が無効です。 |
|
ドライバーがインストールされていません。 |
|
システムがメモリを割り当てまたはロックできません。 |
解説
システムに存在する MIDI 入力デバイスの数を確認するには、 midiInGetNumDevs 関数を 使用します。
要件
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | mmeapi.h (Windows.h を含む) |
Library | Winmm.lib |
[DLL] | Winmm.dll |