acmFilterDetails 函式 (msacm.h)

acmFilterDetails 函式會查詢 ACM,以取得具有特定電壓音訊篩選標籤之篩選的詳細資料。

語法

MMRESULT ACMAPI acmFilterDetails(
  HACMDRIVER         had,
  LPACMFILTERDETAILS pafd,
  DWORD              fdwDetails
);

參數

had

ACM 驅動程式的控制碼,以查詢篩選標籤的電壓音訊篩選詳細資料。 如果此參數為 Null,ACM 會使用第一個適合 ACM 驅動程式的詳細資料。

pafd

要接收指定篩選標籤之篩選詳細資料的 ACMFILTERDETAILS 結構的指標。

fdwDetails

取得詳細資料的旗標。 定義下列值。

已指定 [ACMFILTERDETAILS] () 結構,而且應該傳回其餘的詳細資料。 ACMFILTERDETAILS結構的dwFilterTag成員必須初始化為相同的篩選標籤pwfltr指定。 此查詢類型可用來取得任意篩選結構的字串描述。 如果應用程式指定 的 ACM 驅動程式控制碼 則會針對該驅動程式傳回篩選的詳細資料。 如果應用程式為指定Null,ACM 會尋找第一個可接受的驅動程式來傳回詳細資料。
意義
ACM_FILTERDETAILSF_FILTER
ACM_FILTERDETAILSF_INDEX 篩選標籤的篩選索引是在ACMFILTERDETAILS結構的dwFilterIndex成員中提供。 篩選詳細資料將會在 pafd所定義的結構中傳回。 索引的範圍從零到一個小於篩選標記之 ACMFILTERTAGDETAILS結構中傳回的cStandardFilters成員。 使用這個旗標擷取篩選詳細資料時,應用程式必須指定 驅動程式控制碼。 如需呼叫此函式之前應該初始化哪些成員的資訊,請參閱 ACMFILTERDETAILS 結構。

傳回值

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

傳回碼 描述
ACMERR_NOTPOSSIBLE
要求的詳細資料無法使用。
MMSYSERR_INVALFLAG
至少有一個旗標無效。
MMSYSERR_INVALHANDLE
指定的控制碼無效。
MMSYSERR_INVALPARAM
至少有一個參數無效。

需求

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

另請參閱

音訊壓縮函式

音訊壓縮管理員