次の方法で共有

mixerGetDevCapsA 関数 (mmeapi.h)

  • [アーティクル]

mixerGetDevCaps 関数は、指定されたミキサー デバイスを照会してその機能を判断します。

構文

MMRESULT mixerGetDevCapsA(
  UINT_PTR     uMxId,
  LPMIXERCAPSA pmxcaps,
  UINT         cbmxcaps
);

パラメーター

uMxId

開いているミキサー デバイスの識別子またはハンドル。

pmxcaps

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

cbmxcaps

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

戻り値

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

リターン コード 形容
MMSYSERR_BADDEVICEID
 指定されたデバイス識別子が範囲外です。
MMSYSERR_INVALHANDLE
 ミキサー デバイス ハンドルが無効です。
MMSYSERR_INVALPARAM
 1 つ以上のパラメーターが無効です。

備考

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

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

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

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー mmeapi.h (Windows.h を含む)
ライブラリ Winmm.lib
DLL Winmm.dll

関連項目

オーディオミキサー機能

オーディオ ミキサー