auxGetDevCapsW 関数 (mmeapi.h)

  • [アーティクル]

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

構文

MMRESULT auxGetDevCapsW(
  UINT_PTR   uDeviceID,
  LPAUXCAPSW pac,
  UINT       cbac
);

パラメーター

uDeviceID

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

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

pac

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

cbac

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

戻り値

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

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

注釈

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

注意

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

要件

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

こちらもご覧ください

波形オーディオ

波形関数