acmMetrics 関数 (msacm.h)

acmMetrics 関数は、ACM または関連する ACM オブジェクトのさまざまなメトリックを返します。

構文

MMRESULT ACMAPI acmMetrics(
  HACMOBJ hao,
  UINT    uMetric,
  LPVOID  pMetric
);

パラメーター

hao

uMetric で指定されたメトリックに対してクエリを実行する ACM オブジェクトを処理します。 一部のクエリでは、このパラメーターは NULL にすることができます

uMetric

pMetric で返されるメトリック インデックス。

説明
ACM_METRIC_COUNT_CODECS 戻り値は、システム内のグローバル ACM 圧縮機または圧縮解除ドライバーの数です。 このメトリック インデックスの hao パラメーターは NULL である必要があります。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。
ACM_METRIC_COUNT_CONVERTERS 戻り値は、システム内のグローバル ACM コンバーター ドライバーの数です。 このメトリック インデックスの hao パラメーターは NULL である必要があります。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。
ACM_METRIC_COUNT_DISABLED 返される値は、システム内のグローバルに無効になっている ACM ドライバー (すべてのサポートの種類) の合計数です。 このメトリック インデックスの hao パラメーターは NULL である必要があります。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。 ACM_METRIC_COUNT_DRIVERSとACM_METRIC_COUNT_DISABLEDメトリック インデックスの合計は、グローバルにインストールされた ACM ドライバーの合計数です。
ACM_METRIC_COUNT_DRIVERS 返される値は、システムで有効になっているグローバル ACM ドライバー (すべてのサポートの種類) の合計数です。 このメトリック インデックスの hao パラメーターは NULL である必要があります。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。
ACM_METRIC_COUNT_FILTERS 返される値は、システム内のグローバル ACM フィルター ドライバーの数です。 このメトリック インデックスの hao パラメーターは NULL である必要があります。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。
ACM_METRIC_COUNT_HARDWARE 返される値は、システム内のグローバル ACM ハードウェア ドライバーの数です。 このメトリック インデックスの hao パラメーターは NULL である必要があります。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。
ACM_METRIC_COUNT_LOCAL_CODECS 戻り値は、呼び出し元タスクのローカル ACM 圧縮ドライバー、ACM 圧縮解除ドライバー、またはその両方の数です。 このメトリック インデックスの hao パラメーターは NULL である必要があります。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。
ACM_METRIC_COUNT_LOCAL_CONVERTERS 戻り値は、呼び出し元タスクのローカル ACM コンバーター ドライバーの数です。 このメトリック インデックスの hao パラメーターは NULL である必要があります。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。
ACM_METRIC_COUNT_LOCAL_DISABLED 戻り値は、呼び出し元タスクのすべてのサポートの種類のローカルで無効な ACM ドライバーの合計数です。 このメトリック インデックスの hao パラメーターは NULL である必要があります。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。 ACM_METRIC_COUNT_LOCAL_DRIVERSとACM_METRIC_COUNT_LOCAL_DISABLEDメトリック インデックスの合計は、ローカルにインストールされている ACM ドライバーの合計数です。
ACM_METRIC_COUNT_LOCAL_DRIVERS 戻り値は、呼び出し元タスクに対して有効なローカル ACM ドライバー (すべてのサポートの種類) の合計数です。 このメトリック インデックスの hao パラメーターは NULL である必要があります。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。
ACM_METRIC_COUNT_LOCAL_FILTERS 戻り値は、呼び出し元タスクのローカル ACM フィルター ドライバーの数です。 このメトリック インデックスの hao パラメーターは NULL である必要があります。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。
ACM_METRIC_DRIVER_PRIORITY 戻り値は、指定したドライバーの現在の優先度です。 hao パラメーターは、HACMDRIVERID データ型の有効な ACM ドライバー識別子である必要があります。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。
ACM_METRIC_DRIVER_SUPPORT 返される値は、指定されたドライバーの fdwSupport フラグです。 hao パラメーターは、HACMDRIVERID データ型の有効な ACM ドライバー識別子である必要があります。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。
ACM_METRIC_HARDWARE_WAVE_INPUT 戻り値は、指定されたドライバーに関連付けられている波形オーディオ入力デバイス識別子です。 hao パラメーターは、ACMDRIVERDETAILS_SUPPORTF_HARDWARE フラグをサポートする HACMDRIVERID データ型の有効な ACM ドライバー識別子である必要があります。 波形オーディオ入力デバイスがドライバーに関連付けられていない場合は、MMSYSERR_NOTSUPPORTEDが返されます。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。
ACM_METRIC_HARDWARE_WAVE_OUTPUT 戻り値は、指定されたドライバーに関連付けられている波形オーディオ出力デバイス識別子です。 hao パラメーターは、ACMDRIVERDETAILS_SUPPORTF_HARDWARE フラグをサポートする HACMDRIVERID データ型の有効な ACM ドライバー識別子である必要があります。 波形オーディオ出力デバイスがドライバーに関連付けられていない場合は、MMSYSERR_NOTSUPPORTEDが返されます。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。
ACM_METRIC_MAX_SIZE_FILTER 戻り値は、最大の WAVEFILTER 構造体のサイズです。 haoNULL の場合、戻り値はシステム内で最大の WAVEFILTER 構造体です。 HAOHACMDRIVER データ型の ACM ドライバーの開いているインスタンスまたは HACMDRIVERID データ型の ACM ドライバー識別子を識別する場合は、そのドライバーの最大の WAVEFILTER 構造体が返されます。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。 このメトリックは、 HACMSTREAM データ型の ACM ストリーム ハンドルには使用できません。
ACM_METRIC_MAX_SIZE_FORMAT 戻り値は、最大の WAVEFORMATEX 構造体のサイズです。 haoNULL の場合、戻り値はシステム内で最大の WAVEFORMATEX 構造体になります。 HAOHACMDRIVER データ型の ACM ドライバーのオープン インスタンスまたは HACMDRIVERID データ型の ACM ドライバー識別子を識別する場合は、そのドライバーの最大の WAVEFORMATEX 構造体が返されます。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。 このメトリックは、 HACMSTREAM データ型の ACM ストリーム ハンドルには使用できません。

pMetric

メトリックの詳細を受け取るバッファーへのポインター。 正確な定義は uMetric インデックスによって異なります。

戻り値

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

リターン コード 説明
ACMERR_NOTPOSSIBLE
uMetric で指定されたインデックスは、指定された hao に対して返すことができません。
MMSYSERR_INVALHANDLE
指定されたハンドルが無効です。
MMSYSERR_INVALPARAM
少なくとも 1 つのパラメーターが無効です。
MMSYSERR_NOTSUPPORTED
uMetric で指定されたインデックスはサポートされていません。

要件

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

関連項目

オーディオ圧縮関数

オーディオ圧縮マネージャー