ACMFORMATDETAILS 結構 (msacm.h)

發行項
03/05/2024

ACMFORMATDETAILS 結構詳細說明 ACM 驅動程式特定格式標籤的電壓音訊格式。

語法

typedef struct tACMFORMATDETAILS {
  DWORD          cbStruct;
  DWORD          dwFormatIndex;
  DWORD          dwFormatTag;
  DWORD          fdwSupport;
  LPWAVEFORMATEX pwfx;
  DWORD          cbwfx;
  char           szFormat[ACMFORMATDETAILS_FORMAT_CHARS];
} ACMFORMATDETAILS, *PACMFORMATDETAILS, *LPACMFORMATDETAILS;

成員

cbStruct

ACMFORMATDETAILS 結構的大小，以位元組為單位。在應用程式呼叫 acmFormatDetails 或 acmFormatEnum 函式之前，必須先初始化這個成員。這個成員所指定的大小必須夠大，才能包含基底 ACMFORMATDETAILS 結構。當 acmFormatDetails 函式傳回時，此成員會包含傳回之資訊的實際大小。傳回的信息永遠不會超過要求的大小。

dwFormatIndex

要擷取詳細數據之格式的索引。索引的範圍從零到一個小於 ACM 驅動程式針對格式捲標支援的標準格式數目。驅動程式針對格式標籤支援的標準格式數目包含在 ACMFORMATTAGDETAILS 結構中。只有在應用程式依索引查詢有關驅動程式的標準格式詳細數據時， 才會使用 dwFormatIndex 成員;否則，此成員應為零。此外，當應用程式查詢格式詳細數據時，ACM 會將這個成員設定為零;換句話說，這個成員只會用於輸入，而且永遠不會由 ACM 或 ACM 驅動程式傳回。

dwFormatTag

ACMFORMATDETAILS 結構所描述的波狀音訊格式標籤。此成員用於ACM_FORMATDETAILSF_INDEX查詢旗標的輸入。針對ACM_FORMATDETAILSF_FORMAT查詢旗標，此成員必須初始化為 與 pwfx 成員指定的相同格式標記。如果 acmFormatDetails 函式的呼叫成功，則一律會傳回這個成員。此成員應設定為所有其他查詢旗標WAVE_FORMAT_UNKNOWN。

fdwSupport

驅動程式支援旗標專屬於指定的格式。這些旗標與 ACMDRIVERDETAILS 結構相同。這個成員可以是下列值的組合，並指出驅動程式支援的格式標記作業：

名稱	描述
ACMDRIVERDETAILS_SUPPORTF_ASYNC	驅動程式支援使用指定的格式捲標進行異步轉換。
ACMDRIVERDETAILS_SUPPORTF_CODEC	驅動程式支援在指定格式的兩個不同格式標記之間進行轉換。例如，如果驅動程式支援從WAVE_FORMAT_PCM壓縮到具有指定格式的WAVE_FORMAT_ADPCM，則會設定此旗標。
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	驅動程式支援使用指定格式時，在相同格式標記的兩種不同格式之間進行轉換。例如，如果驅動程式支援將WAVE_FORMAT_PCM重新取樣為指定的格式，則會設定此旗標。
ACMDRIVERDETAILS_SUPPORTF_FILTER	驅動程式支援篩選 (，可修改數據，而不需變更具有指定格式的任何格式屬性) 。例如，如果驅動程式支援WAVE_FORMAT_PCM上的磁碟區或回應作業，則會設定此旗標。
ACMDRIVERDETAILS_SUPPORTF_HARDWARE	驅動程式透過電壓音訊裝置支援指定格式的硬體輸入和/或輸出。應用程式應該使用 acmMetrics 搭配ACM_METRIC_HARDWARE_WAVE_INPUT和ACM_METRIC_HARDWARE_WAVE_OUTPUT計量索引，以取得與支援 ACM 驅動程式相關聯的波音頻裝置標識碼。

pwfx

將接收格式詳細數據之一個其之一的「WAVEFORMATEX 」結構的指標。除非 acmFormatDetails 函式中指定了ACM_FORMATDETAILSF_FORMAT旗標，否則此結構不需要應用程式初始化。在此案例中，其與ACMFORMATDETAILS 結構的 dwFormatTag 成員相等。

cbwfx

大小，以位元組為單位，可供 pwfx 接收格式詳細數據。 acmMetrics 和 acmFormatTagDetails 函式可用來判斷指定驅動程式 (或所有已安裝 ACM 驅動程式所需的大小上限) 。

szFormat[ACMFORMATDETAILS_FORMAT_CHARS]

描述 dwFormatTag 類型格式的字串。如果 acmFormatDetails 函式成功，則一律會傳回此字串。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	msacm.h