midiOutGetDevCapsW

midiOutGetDevCapsW (Unicode) 関数 (mmeapi.h) は指定された MIDI 出力デバイスに問い合わせてその機能を判定する。

midiOutGetDevCapsW uDeviceID, pmoc, cbmoc

uDeviceID : [int] MIDI 出力デバイスの識別子。このパラメータで指定するデバイス識別子は 0 から存在するデバイスの数より 1 少ない値までの範囲となる。MIDI_MAPPER 定数も有効なデバイス識別子である。このパラメータは適切にキャストされたデバイスハンドルでもよい。
pmoc : [var] MIDIOUTCAPS 構造体へのポインタ。この構造体にデバイスの機能に関する情報が格納される。
cbmoc : [int] MIDIOUTCAPS 構造体のサイズ (バイト単位)。lpMidiOutCaps が指す場所には cbMidiOutCaps バイト (またはそれ以下) の情報のみコピーされる。cbMidiOutCaps が 0 の場合は何もコピーされず、関数は MMSYSERR_NOERROR を返す。

(プラグイン / モジュール : winmm.dll)

解説

midiOutGetDevCapsW (Unicode) 関数 (mmeapi.h) は指定された MIDI
出力デバイスに問い合わせてその機能を判定する。

[戻り値]
成功時は MMSYSERR_NOERROR を、それ以外の場合はエラーを返す。考えられるエラー値は次のとおり。
（以下省略）

[備考]
システムに存在する MIDI 出力デバイスの数を判定するには midiOutGetNumDevs 関数を使用する。
> [!NOTE] > mmeapi.h ヘッダは midiOutGetDevCaps をエイリアスとして定義し、UNICODE
プリプロセッサ定数の定義に基づき本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとそうでないコードを混在させるとコンパイルエラーや実行時エラーの原因となる不一致が発生し得る。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報