acmFilterTagDetails 函式 (msacm.h)
acmFilterTagDetails 函式會查詢 ACM,以取得特定波音頻篩選標記的詳細數據。
語法
MMRESULT ACMAPI acmFilterTagDetails(
HACMDRIVER had,
LPACMFILTERTAGDETAILS paftd,
DWORD fdwDetails
);
參數
had
ACM 驅動程式的句柄,以查詢波音頻篩選標籤詳細數據。 如果此參數為 NULL,ACM 會使用第一個適合 ACM 驅動程式的詳細數據。 使用ACM_FILTERTAGDETAILSF_INDEX查詢類型時,應用程式必須指定有效的 HACMDRIVER 或 HACMDRIVERID 識別碼。 不允許停用驅動程式的驅動程式標識碼。
paftd
要接收篩選標記詳細數據的 ACMFILTERTAGDETAILS 結構的指標。
fdwDetails
取得詳細數據的旗標。 定義下列值。
值 | 意義 |
---|---|
ACM_FILTERTAGDETAILSF_FILTERTAG | [ACMFILTERTAGDETAILS] () 結構。 篩選標籤詳細數據將會在 paftd所指向的結構中傳回。 如果應用程式指定的 ACM 驅動程式句 柄,則會針對該驅動程式傳回篩選標籤的詳細數據。 如果應用程式針對 指定NULL,ACM 會尋找第一個可接受的驅動程式來傳回詳細數據。|
ACM_FILTERTAGDETAILSF_INDEX | [ACMDRIVERDETAILS] (./nf-msacm-acmdriverdetails.md) ACM 驅動程序的結構。 使用這個旗標擷取篩選標記 詳細數據時 ,應用程式必須指定的驅動程式句柄。|
ACM_FILTERTAGDETAILSF_LARGESTSIZE | 將會傳回具有最大篩選大小之篩選卷標的詳細數據,以位元組為單位。 dwFilterTag 成員必須是WAVE_FILTER_UNKNOWN或篩選標籤,才能尋找的最大大小。 如果應用程式指定的 ACM 驅動程式句 柄,則會針對該驅動程式傳回最大篩選標籤的詳細數據。 如果應用程式針對 指定 NULL,ACM 會尋找可接受的驅動程式,其中要求傳回詳細數據的最大篩選標籤。 |
傳回值
如果成功或發生錯誤,則傳回零。 可能的錯誤值包括下列專案。
傳回碼 | Description |
---|---|
|
要求的詳細數據無法使用。 |
|
至少有一個旗標無效。 |
|
指定的句柄無效。 |
|
至少有一個參數無效。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | msacm.h |
程式庫 | Msacm32.lib |
Dll | Msacm32.dll |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應