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 構造体のサイズです。 hao が NULL の場合、戻り値はシステム内で最大の WAVEFILTER 構造体です。 HAO が HACMDRIVER データ型の ACM ドライバーの開いているインスタンスまたは HACMDRIVERID データ型の ACM ドライバー識別子を識別する場合は、そのドライバーの最大の WAVEFILTER 構造体が返されます。 pMetric パラメーターは、DWORD 値と等しいサイズのバッファーを指す必要があります。 このメトリックは、 HACMSTREAM データ型の ACM ストリーム ハンドルには使用できません。
ACM_METRIC_MAX_SIZE_FORMAT	戻り値は、最大の WAVEFORMATEX 構造体のサイズです。 hao が NULL の場合、戻り値はシステム内で最大の WAVEFORMATEX 構造体になります。 HAO が HACMDRIVER データ型の 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

関連項目

オーディオ圧縮関数

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