mixerGetDevCapsW

mixerGetDevCapsW (Unicode) 関数 (mmeapi.h) は指定されたミキサーデバイスに問い合わせてその機能を判定する。

mixerGetDevCapsW uMxId, pmxcaps, cbmxcaps

uMxId : [int] オープン済みミキサーデバイスの識別子またはハンドル。
pmxcaps : [var] デバイスの機能に関する情報を受け取る MIXERCAPS 構造体へのポインタ。
cbmxcaps : [int] MIXERCAPS 構造体のサイズ (バイト単位)。

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

解説

mixerGetDevCapsW (Unicode) 関数 (mmeapi.h)
は指定されたミキサーデバイスに問い合わせてその機能を判定する。

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

[備考]
システムに存在するミキサーデバイスの数を判定するには mixerGetNumDevs 関数を使用する。uMxId
で指定されるデバイス識別子は 0 から存在するミキサーデバイスの数より 1 少ない値までの範囲となる。pmxcaps が指す場所には
cbmxcaps で指定したバイト数 (またはそれ以下) の情報のみコピーされる。cbmxcaps が 0
の場合は何もコピーされず、関数は正常に戻る。本関数は mixerOpen 関数によって返されたミキサーデバイスハンドルも uMxId
パラメータとして受け入れる。アプリケーションは HMIXER ハンドルを UINT にキャストする必要がある。
> [!NOTE] > mmeapi.h ヘッダは mixerGetDevCaps をエイリアスとして定義し、UNICODE
プリプロセッサ定数の定義に基づき本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとそうでないコードを混在させるとコンパイルエラーや実行時エラーの原因となる不一致が発生し得る。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報