acmFormatTagDetails 函式會查詢 ACM,以取得特定電壓音訊格式標記的詳細數據。
語法
MMRESULT ACMAPI acmFormatTagDetails(
HACMDRIVER had,
LPACMFORMATTAGDETAILS paftd,
DWORD fdwDetails
);
參數
had
ACM 驅動程式的句柄,以查詢電壓音訊格式標記詳細數據。 如果此參數為 NULL,ACM 會使用第一個適合 ACM 驅動程式的詳細數據。 使用ACM_FORMATTAGDETAILSF_INDEX查詢類型時,應用程式必須指定有效的句柄或驅動程式標識碼。 不允許停用驅動程式的驅動程式標識碼。
paftd
要接收格式標記詳細數據的 ACMFORMATTAGDETAILS 結構的指標。
fdwDetails
取得詳細數據的旗標。 定義下列值。
[ACMFORMATTAGDETAILS] () 結構。 格式標記詳細數據將會在 paftd所指向的結構中傳回。 如果應用程式指定的 ACM 驅動程式句柄 ,則會針對該驅動程式傳回格式標記的詳細數據。 如果應用程式為 指定NULL,ACM 會尋找第一個可接受的驅動程式來傳回詳細數據。 [ACMDRIVERDETAILS] (./nf-msacm-acmdriverdetails.md) ACM 驅動程序的結構。 使用這個旗標擷取格式標記 詳細數據時 ,應用程式必須指定的驅動程式句柄。 [ACMFORMATTAGDETAILS] () 結構必須WAVE_FORMAT_UNKNOWN或格式標記,才能尋找最大的大小。 如果應用程式 指定的 ACM 驅動程式句柄,則會針對該驅動程式傳回最大格式標記的詳細數據。 如果應用程式針對 had 指定 NULL,ACM 會尋找可接受的驅動程式,其中包含要求傳回詳細數據的最大格式標記。| 值 | 意義 |
|---|---|
| ACM_FORMATTAGDETAILSF_FORMATTAG | |
| ACM_FORMATTAGDETAILSF_INDEX | |
| ACM_FORMATTAGDETAILSF_LARGESTSIZE |
傳回值
如果成功或發生錯誤,則傳回零。 可能的錯誤值包括下列專案。
| 傳回碼 | Description |
|---|---|
|
要求的詳細數據無法使用。 |
|
至少有一個旗標無效。 |
|
指定的句柄無效。 |
|
至少有一個參數無效。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | msacm.h |
| 程式庫 | Msacm32.lib |
| Dll | Msacm32.dll |