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 を返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
uMetric で指定されたインデックスは、指定された hao に対して返すことができません。 |
|
指定されたハンドルが無効です。 |
|
少なくとも 1 つのパラメーターが無効です。 |
|
uMetric で指定されたインデックスはサポートされていません。 |
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | msacm.h |
| Library | Msacm32.lib |
| [DLL] | Msacm32.dll |