auxGetDevCapsW 関数 (mmeapi.h)
auxGetDevCaps 関数は、特定の補助出力デバイスの機能を取得します。
構文
MMRESULT auxGetDevCapsW(
UINT_PTR uDeviceID,
LPAUXCAPSW pac,
UINT cbac
);
パラメーター
uDeviceID
照会する補助出力デバイスの識別子。 有効なデバイス識別子を指定するか (次のコメント セクションを参照)、または次の定数を使用します。
価値 | 意味 |
---|---|
AUX_MAPPER | 補助オーディオ マッパー。 補助オーディオ マッパーがインストールされていない場合、この関数はエラーを返します。 |
pac
デバイスの機能に関する情報が格納される AUXCAPS 構造体へのポインター。
cbac
AUXCAPS 構造体のサイズ (バイト単位)。
戻り値
成功した場合はMMSYSERR_NOERRORを返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。
リターン コード | 形容 |
---|---|
|
指定されたデバイス識別子が範囲外です。 |
備考
uDeviceID 内のデバイス識別子は、存在するデバイスの数より 0 から 1 未満に変化します。 AUX_MAPPERも使用できる。 auxGetNumDevs 関数を使用して、システムに存在する補助出力デバイスの数を決定します。
手記
mmeapi.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして auxGetDevCaps を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | mmeapi.h (Windows.h を含む) |
ライブラリ | Winmm.lib |
DLL | Winmm.dll |