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 結構。 |
傳回值
如果成功或發生錯誤,則傳回零。 可能的錯誤值包括下列專案。
傳回碼 | 描述 |
---|---|
|
要求的詳細資料無法使用。 |
|
至少有一個旗標無效。 |
|
指定的控制碼無效。 |
|
至少有一個參數無效。 |
需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | msacm.h |
程式庫 | Msacm32.lib |
Dll | Msacm32.dll |