acmFormatTagEnum 函式 (msacm.h)
acmFormatTagEnum 函式會列舉 ACM 驅動程式提供的電壓音訊格式標籤。 此函式會繼續列舉,直到沒有更適當的格式標記或回呼函式傳回 FALSE 為止。
語法
MMRESULT ACMAPI acmFormatTagEnum(
HACMDRIVER had,
LPACMFORMATTAGDETAILS paftd,
ACMFORMATTAGENUMCB fnCallback,
DWORD_PTR dwInstance,
DWORD fdwEnum
);
參數
had
ACM 驅動程式的句柄,以查詢電壓音訊格式標籤詳細數據。 如果此參數為 NULL,ACM 會使用第一個適合 ACM 驅動程式的詳細數據。
paftd
ACMFORMATTAGDETAILS 結構的指標,該結構會接收傳遞至 fnCallback 中所指定函式的格式標記詳細數據。 這個結構必須初始化 ACMFORMATTAGDETAILS 結構的 cbStruct 成員。
fnCallback
應用程式定義回呼函式的程序實例位址。
dwInstance
64 位 (DWORD_PTR) 或 32 位 (DWORD) 傳遞至回呼函式的應用程式定義值,以及 ACM 格式標籤詳細數據。
fdwEnum
保留;必須是零。
傳回值
如果成功或發生錯誤,則傳回零。 可能的錯誤值包括下列專案。
傳回碼 | Description |
---|---|
|
至少有一個旗標無效。 |
|
指定的句柄無效。 |
|
至少有一個參數無效。 |
備註
如果未安裝適當的 ACM 驅動程式,此函式會傳回零MMSYSERR_NOERROR (零) 。 此外,不會呼叫回呼函式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | msacm.h |
程式庫 | Msacm32.lib |
Dll | Msacm32.dll |