acmMetrics

Declare Function Api_acmMetrics& Lib "msacm32" Alias "acmMetrics" (ByVal hao&, ByVal uMetric&, pMetric As Any)

Declare Function acmMetrics Lib "msacm32" (ByVal hao As Long, ByVal uMetric As Long, pMetric As Any) As Long

ACM またはそれに関連する ACM オブジェクトのさまざまなメトリックを取得する。

パラメータ

hao

    uMetric パラメータで指定されたメトリックを照会する、ACM オブジェクトのハンドルを指定する。照会によっては、このパラメータには NULL

    を指定できる。

uMetric

    pMetric パラメータに返されるメトリックインデックスを指定する。
    ACM_METRIC_COUNT_CODECS
        戻り値は、システムのグローバル ACM コンプレッサまたはデコンプレッサドライバの数である。このメトリックインデックスに対しては、hao

        パラメータで NULL を指定しなければならない。また、pMetric パラメータで、ダブルワード値と同じサイズのバッファを指定しなければな

        らない。
    ACM_METRIC_COUNT_CONVERTERS
        戻り値は、システムのグローバル ACM コンバータドライバの数である。このメトリックインデックスに対しては、hao パラメータで NULL を

        指定しなければならない。また、pMetric パラメータで、ダブルワード値と同じサイズのバッファを指指定しなければならない。
    ACM_METRIC_COUNT_DISABLED
        戻り値は、システムの無効なグローバル ACM ドライバ(全サポートタイプ)の総数である。このメトリックインデックスに対しては、hao パラメ

        ータで NULL でなければならない。また、pMetric パラメータで、ダブルワード値と同じサイズのバッファを指定しなければならな

        い。ACM_METRIC_COUNT_DRIVERS と ACM_METRIC_COUNT_DISABLED メトリックインデックスの和が、グローバルにインスト

        ールされた ACM ドライバの総数である。
    ACM_METRIC_COUNT_DRIVERS
        戻り値は、システムの有効なグローバル ACM ドライバ(全サポートタイプ)の総数である。このメトリックインデックスに対しては、hao パラメ

        ータで NULL を指定しなければならない。また、pMetric パラメータで、ダブルワード値と同じサイズのバッファを指定しなければならな

        い。
    ACM_METRIC_COUNT_FILTERS
        戻り値は、システムのグローバル ACM フィルタドライバの数である。このメトリックインデックスに対しては、hao パラメータで NULL を指

        定しなければならない。また、pMetric パラメータで、ダブルワード値と同じサイズのバッファをを指定しなければならない。
    ACM_METRIC_COUNT_HARDWARE
        戻り値は、システムのグローバル ACM ハードウェアドライバの数である。このメトリックインデックスに対しては、hao パラメータで NULL

        を指定しなければならない。また、pMetric パラメータで、ダブルワード値と同じサイズのバッファを指定しなければならない。
    ACM_METRIC_COUNT_LOCAL_CODECS
        戻り値は、呼び出し側タスクのローカル ACM コンプレッサドライバか ACM デコンプレッサドライバ、またはその両方の数である。このメト

        リックインデックスに対しては、hao パラメータで NULL を指定しなければならない。また、pMetric パラメータで、ダブルワード値と同じサ

        イズのバッファを指定しなければならない。
    ACM_METRIC_COUNT_LOCAL_CONVERTERS
        戻り値は、呼び出し側タスクのローカル ACM コンバータドライバの数である。このメトリックインデックスに対しては、hao パラメータで

        NULL を指定しなければならない。また、pMetric パラメータで、ダブルワード値と同じサイズのバッファを指定しなければならない。
    ACM_METRIC_COUNT_LOCAL_DISABLED
        戻り値は、呼び出し側タスクの無効なローカル ACM ドライバ(全サポートタイプ)の総数である。このメトリックインデックスに対しては、hao

        パラメータで NULL を指定しなければならない。また、pMetric パラメータで、ダブルワード値と同じサイズのバッファを指定しなければな

        らない。ACM_METRIC_COUNT_LOCAL_DRIVERS と ACM_METRIC_COUNT_LOCAL_DISABLED メトリックインデックスの和

        が、ローカルにインストールされた ACM ドライバの総数である。
    ACM_METRIC_COUNT_LOCAL_DRIVERS
        戻り値は、呼び出し側タスクの有効なローカル ACM ドライバ(全サポートタイプ)の総数である。このメトリックインデックスに対しては、hao

        パラメータで NULL を指定しなければならない。

        pMetric パラメータで、ダブルワード値と同じサイズのバッファを指定しなければならない。
    ACM_METRIC_COUNT_LOCAL_FILTERS
        戻り値は、呼び出し側タスクのローカル ACM フィルタドライバの数である。このメトリックインデックスに対しては、hao パラメータで NULL

        を指定しなければならない。また、pMetric パラメータで、ダブルワード値と同じサイズのバッファを指定しなければならない。
    ACM_METRIC_DRIVER_PRIORITY
        戻り値は、指定されたドライバの現在の優先順位である。hao パラメータで、HACMDRIVERID データタイプの有効な ACM ドライバ識

        別子を指定しなければならない。また、pMetric パラメータで、ダブルワード値と同じサイズのバッファを指定しなければならない。
    ACM_METRIC_DRIVER_SUPPORT
        戻り値は、指定されたドライバの fdwSupport フラグである。hao パラメータで HACMDRIVERID データタイプの有効な ACM ドライバ識

        別子を指定しなければならない。また、pMetric パラメータで、ダブルワード値と同じサイズのバッファを指定しなければならない。
    ACM_METRIC_HARDWARE_WAVE_INPUT
        戻り値は、指定されたドライバに関連付けられたウェーブフォームオーディオ入力デバイス識別子である。hao パラメータで、

        ACMDRIVERDETAILS_SUPPORTF_HARDWARE フラグをサポートする HACMDRIVERID データタイプの有効な ACM ドライバ識別

        子を指定しなければならない。ドライバに関連付けられているウェーブフォームオーディオ入力デバイスが存在しない場合は、

        MMSYSERR_NOTSUPPORTED が返される。

        pMetric パラメータで、ダブルワード値と同じサイズのバッファを指定しなければならない。
    ACM_METRIC_HARDWARE_WAVE_OUTPUT
        戻り値は、指定されたドライバに関連付けられたウェーブフォームオーディオ出力デバイス識別子である。hao パラメータで、

        ACMDRIVERDETAILS_SUPPORTF_HARDWARE フラグをサポートする HACMDRIVERID データタイプの有効な ACM ドライバ識別

        子を指定しなければならない。ドライバに関連付けられているウェーブフォームオーディオ出力デバイスが存在しない場合は、

        MMSYSERR_NOTSUPPORTED が返される。

        pMetric パラメータで、ダブルワード値と同じサイズのバッファを指定しなければならない。
    ACM_METRIC_MAX_SIZE_FILTER
        戻り値は、最大の 構造体のサイズである。hao パラメータに NULL を指定した場合、戻り値はシステムの最大の WAVEFILTER 構

        造体になる。hao パラメータに HACMDRIVER データタイプの開いている ACM ドライバのインスタンスか、または HACMDRIVERID デ

        ータタイプの ACM ドライバ識別子を指定した場合は、そのドライバに対する最大の WAVEFILTER 構造体が返される。pMetric パラメ

        ータには、ダブルワード値と同じサイズのバッファを指定しなければならない。このメトリックは、HACMSTREAM データタイプの ACM スト

        リームハンドルには対応しない。
    ACM_METRIC_MAX_SIZE_FORMAT
        戻り値は、最大の 構造体のサイズである。hao パラメータに NULL を指定した場合、戻り値はシステムにある最大の

        WAVEFORMATEX 構造体になる。hao パラメータに HACMDRIVER データタイプの開いている ACM ドライバのインスタンスか、または

      HACMDRIVERID データタイプの ACM ドライバ識別子を指定した場合、そのドライバに対する最大の WAVEFORMATEX 構造体が返

        される。pMetric パラメータには、ダブルワード値と同じサイズのバッファを指定しなければならない。このメトリックは、HACMSTREAM

        データタイプの ACM ストリームハンドルには対応しない。
pMetric

    メトリックの詳細を受け取るバッファのアドレスを指定する。正確な定義は、uMetric インデックスによって異なる。

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

値	説明
ACMERR_NOTPOSSIBLE	hao パラメータで指定された ACM オブジェクトについては、uMetric パラメータで指定されたインデックスを返すことができない。
MMSYSERR_INVALHANDLE	指定されたハンドルは無効である。
MMSYSERR_INVALPARAM	ACM ドライバはメッセージを処理しなかった。
MMSYSERR_NOTSUPPORTED	UMetric パラメータで指定されたインデックスはサポートされていない。