acmFormatDetailsA 函式 (msacm.h)
acmFormatDetails 函式會查詢 ACM 以取得特定電壓音訊格式標記的格式詳細資料。
語法
MMRESULT ACMAPI acmFormatDetailsA(
HACMDRIVER had,
LPACMFORMATDETAILSA pafd,
DWORD fdwDetails
);
參數
had
ACM 驅動程式的控制碼,以查詢格式標記的電壓音訊格式詳細資料。 如果此參數為 Null,ACM 會使用第一個適合 ACM 驅動程式的詳細資料。
pafd
ACMFORMATDETAILS結構的指標,以包含指定格式標記的格式詳細資料。
fdwDetails
取得電壓音訊格式標籤詳細資料的旗標。 定義下列值。
[ACMFORMATDETAILS] (./nf-msacm-acmformatdetails.md) 結構已指定,其餘的詳細資料應傳回。 ACMFORMATDETAILS結構的dwFormatTag成員必須初始化為與 pwfx指定的相同格式標記。 此查詢類型可用來取得任意格式結構的字串描述。 如果應用程式指定 的 ACM 驅動程式控制碼 ,則會針對該驅動程式傳回格式的詳細資料。 如果應用程式為指定Null,ACM 會尋找第一個可接受的驅動程式來傳回詳細資料。值 | 意義 |
---|---|
ACM_FORMATDETAILSF_FORMAT | |
ACM_FORMATDETAILSF_INDEX | 格式標記的格式索引是在ACMFORMATDETAILS結構的dwFormatIndex成員中提供。 格式詳細資料將會在 pafd所定義的結構中傳回。 索引的範圍從零到一個小於格式標記之ACMFORMATTAGDETAILS結構中傳回的cStandardFormats成員。 使用這個旗標擷取格式詳細資料時,應用程式必須指定 的 驅動程式控制碼。 如需呼叫此函式之前應該初始化哪些成員的資訊,請參閱 ACMFORMATDETAILS 結構。 |
傳回值
如果成功或發生錯誤,則傳回零。 可能的錯誤值包括下列專案。
傳回碼 | 描述 |
---|---|
|
要求的詳細資料無法使用。 |
|
至少有一個旗標無效。 |
|
指定的控制碼無效。 |
|
至少有一個參數無效。 |
備註
注意
msacm.h 標頭會將 ACMFORMATDETAILS 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | msacm.h |
程式庫 | Msacm32.lib |
Dll | Msacm32.dll |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應