auxGetDevCaps 関数 (mmeapi.h)

auxGetDevCaps 関数は、指定された補助出力デバイスの機能を取得します。

構文

MMRESULT auxGetDevCaps(
  UINT      uDeviceID,
  LPAUXCAPS pac,
  UINT      cbac
);

uDeviceID

照会する補助出力デバイスの識別子。有効なデバイス識別子を指定するか (次のコメントセクションを参照)、または次の定数を使用します。

値	説明
AUX_MAPPER	補助オーディオマッパー。補助オーディオマッパーがインストールされていない場合、関数はエラーを返します。

pac

デバイスの機能に関する情報が入力される AUXCAPS 構造体へのポインター。

cbac

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

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

リターンコード	説明
MMSYSERR_BADDEVICEID	指定されたデバイス識別子が範囲外です。

uDeviceID のデバイス識別子は、存在するデバイスの数よりも 0 から 1 未満に変化します。 AUX_MAPPERも使用することができる。 auxGetNumDevs 関数を使用して、システムに存在する補助出力デバイスの数を決定します。


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