mixerGetDevCaps 関数 (mmeapi.h)

mixerGetDevCaps 関数は、指定したミキサーデバイスに対してクエリを実行して、その機能を判断します。

構文

MMRESULT mixerGetDevCaps(
  UINT        uMxId,
  LPMIXERCAPS pmxcaps,
  UINT        cbmxcaps
);

uMxId

オープンミキサーデバイスの識別子またはハンドル。

pmxcaps

デバイスの機能に関する情報を受け取る MIXERCAPS 構造体へのポインター。

cbmxcaps

MIXERCAPS 構造体のサイズ (バイト単位)。

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

mixerGetNumDevs 関数を使用して、システムに存在するミキサーデバイスの数を決定します。 uMxId で指定されたデバイス識別子は、存在するミキサーデバイスの数より 0 から 1 未満に変化します。

cbmxcaps で指定された情報のバイト数 (以下) のみが、pmxcaps が指す場所にコピーされます。 cbmxcaps が 0 の場合、何もコピーされません。関数は正常に返されます。

この関数は、 mixerOpen 関数によって返されるミキサーデバイスハンドルも uMxId パラメーターとして受け入れます。アプリケーションは 、HMIXER ハンドルを UINT にキャストする必要があります。

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