acmFormatSuggest 函式 (msacm.h)

acmFormatSuggest函式會查詢 ACM 或指定的 ACM 驅動程式，以建議所提供來源格式的目的地格式。 例如，應用程式可以使用此函式來判斷可解壓縮壓縮格式的一或多個有效 PCM 格式。

語法

MMRESULT ACMAPI acmFormatSuggest(
  HACMDRIVER     had,
  LPWAVEFORMATEX pwfxSrc,
  LPWAVEFORMATEX pwfxDst,
  DWORD          cbwfxDst,
  DWORD          fdwSuggest
);

參數

had

處理驅動程式的開啟實例，以查詢建議的目的地格式。 如果此參數為 Null，ACM 會嘗試尋找建議目的地格式的最佳驅動程式。

pwfxSrc

針對可識別目的地格式將由 ACM 或指定的驅動程式建議的來源格式 之其來源格式的其 POINTERATEX 結構指標。

pwfxDst

將接收pwfxSrc格式之建議目的地格式之其其來源結構的其指標。 根據 fdwSuggest 參數， pwfxDst 所指向的一些結構成員可能需要初始化。

cbwfxDst

大小，以位元組為單位，可用於目的地格式。 acmMetrics和acmFormatTagDetails函式可用來判斷指定驅動程式 (或所有已安裝 ACM 驅動程式所需的大小上限) 。

fdwSuggest

符合所需目的地格式的旗標。 定義下列值。

值	意義
ACM_FORMATSUGGESTF_NCHANNELS	pwfxDst所指向結構的nChannels成員有效。 ACM 會查詢可接受的已安裝驅動程式，以建議符合 nChannels 或失敗的目的地格式。
ACM_FORMATSUGGESTF_NSAMPLESPERSEC	pwfxDst所指向結構的nSamplesPerSec成員有效。 ACM 會查詢可接受的已安裝驅動程式，以建議符合 nSamplesPerSec 或失敗的目的地格式。
ACM_FORMATSUGGESTF_WBITSPERSAMPLE	pwfxDst所指向結構的wBitsPerSample成員有效。 ACM 會查詢可接受的已安裝驅動程式，以建議符合 wBitsPerSample 或失敗的目的地格式。
ACM_FORMATSUGGESTF_WFORMATTAG	pwfxDst所指向結構的wFormatTag成員有效。 ACM 會查詢可接受的已安裝驅動程式，以建議符合 wFormatTag 或失敗的目的地格式。

傳回值

如果成功或發生錯誤，則傳回零。 可能的錯誤值包括下列專案。

傳回碼	描述
MMSYSERR_INVALFLAG	至少有一個旗標無效。
MMSYSERR_INVALHANDLE	指定的控制碼無效。
MMSYSERR_INVALPARAM	至少有一個參數無效。

需求

最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	msacm.h
程式庫	Msacm32.lib
Dll	Msacm32.dll

另請參閱

音訊壓縮函式

音訊壓縮管理員