<Return[A]><Top>

auxGetDevCaps

Declare Function Api_auxGetDevCaps& Lib "winmm" Alias "auxGetDevCapsA" (ByVal uDeviceID&, lpCaps As AUXCAPS, ByVal cbCaps&)

Declare Function auxGetDevCaps Lib "winmm" Alias "auxGetDevCapsA" (ByVal uDeviceID As Long, lpCaps As AUXCAPS, ByVal cbCaps As Long) As Long

指定された補助出力デバイスの機能を取得する。

パラメータ

uDeviceID
    対象になる補助出力デバイスの識別子を指定する。有効なデバイス識別子を指定するか(「解説」を参照)、または次の定数を使う。
    AUX_MAPPER
        補助オーディオマッパである。補助オーディオマッパがインストールされていない場合、エラーが返る。
lpCaps
    指定されたデバイスの機能の情報を受け取る 構造体のアドレスを指定する。
cbCaps
    AUXCAPS 構造体のサイズをバイト単位で指定する。

戻り値
    関数が成功すると MMSYSERR_NOERROR が返る。関数が失敗するとエラーが返る。返されるエラー値は次のとおりである。

    値                                           

説明                                                                          

    MMSYSERR_BADDEVICEID

指定されたデバイス識別子は範囲外のため無効である。


解説
    uDeviceID パラメータのデバイス識別子の範囲は 0〜インストールされているデバイス数 -1 である。システムにインストールされている補

    助出力デバイス数を取得するには、auxGetNumDevs 関数を使う。