acmFormatTagDetails 函式 (msacm.h)

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
ACMERR_NOTPOSSIBLE	要求的詳細數據無法使用。
MMSYSERR_INVALFLAG	至少有一個旗標無效。
MMSYSERR_INVALHANDLE	指定的句柄無效。
MMSYSERR_INVALPARAM	至少有一個參數無效。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	msacm.h
程式庫	Msacm32.lib
Dll	Msacm32.dll

另請參閱

音訊壓縮函式

音訊壓縮管理員