共用方式為

ACMFORMATTAGDETAILS 結構 (msacm.h)

  • 發行項

ACMFORMATTAGDETAILS結構詳細說明 ACM 驅動程式的電壓音訊格式標記。

語法

typedef struct tACMFORMATTAGDETAILS {
  DWORD cbStruct;
  DWORD dwFormatTagIndex;
  DWORD dwFormatTag;
  DWORD cbFormatSize;
  DWORD fdwSupport;
  DWORD cStandardFormats;
  char  szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS];
} ACMFORMATTAGDETAILS, *PACMFORMATTAGDETAILS, *LPACMFORMATTAGDETAILS;

成員

cbStruct

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

dwFormatTagIndex

要擷取詳細資料之格式標記的索引。 索引的範圍從零到一個小於 ACM 驅動程式支援的格式標記數目。 驅動程式所支援的格式標記數目包含在 ACMDRIVERDETAILS 結構中。 dwFormatTagIndex成員只有在依索引查詢驅動程式上的格式標記詳細資料時才會使用;否則，這個成員應該是零。

dwFormatTag

ACMFORMATTAGDETAILS結構所描述的電壓音訊格式標記。 這個成員用於ACM_FORMATTAGDETAILSF_FORMATTAG和ACM_FORMATTAGDETAILSF_LARGESTSIZE查詢旗標的輸入。 如果 acmFormatTagDetails 函 式成功，則一律會傳回這個成員。 這個成員應該設定為所有其他查詢旗標的WAVE_FORMAT_UNKNOWN。

cbFormatSize

dwFormatTag類型之電壓音訊格式的最大大小，以位元組為單位。 例如，此成員會是 16 代表 WAVE_FORMAT_PCM，而 WAVE_FORMAT_ADPCM 則為 50。

fdwSupport

驅動程式支援旗標專屬於格式標記。 這些旗標與 ACMDRIVERDETAILS 結構相同。 此成員可能是下列值的一些組合，並參考驅動程式使用格式標籤所支援的作業：

名稱 描述
ACMDRIVERDETAILS_SUPPORTF_ASYNC
 驅動程式支援使用指定的格式標記進行非同步轉換。
ACMDRIVERDETAILS_SUPPORTF_CODEC
 驅動程式支援在兩個不同的格式標記之間進行轉換，其中其中一個標記是指定的格式標記。 例如，如果驅動程式支援從WAVE_FORMAT_PCM壓縮到WAVE_FORMAT_ADPCM，則會設定此旗標。
ACMDRIVERDETAILS_SUPPORTF_CONVERTER
 驅動程式支援在兩種不同格式的指定格式標記之間進行轉換。 例如，如果驅動程式支援重新取樣WAVE_FORMAT_PCM，則會設定此旗標。
ACMDRIVERDETAILS_SUPPORTF_FILTER
 驅動程式支援篩選 (修改資料，而不需要變更任何格式屬性) 。 例如，如果驅動程式支援指定格式標籤上的磁片區或回應作業，則會設定此旗標。
ACMDRIVERDETAILS_SUPPORTF_HARDWARE
 驅動程式透過電壓音訊裝置支援硬體輸入、輸出或兩者指定的格式標記。 應用程式應該使用 acmMetrics 函式搭配ACM_METRIC_HARDWARE_WAVE_INPUT和ACM_METRIC_HARDWARE_WAVE_OUTPUT計量索引，以取得與支援 ACM 驅動程式相關聯的電壓音訊裝置識別碼。

cStandardFormats

dwFormatTag類型的標準格式數目;也就是說，所有取樣率、每個樣本的位、通道等的組合。 這個值可以指定驅動程式支援的所有格式，但不一定。

szFormatTag[ACMFORMATTAGDETAILS_FORMATTAG_CHARS]

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

需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
標頭 msacm.h

另請參閱

ACMDRIVERDETAILS

音訊壓縮管理員

音訊壓縮結構

acmFormatTagDetails

acmFormatTagEnum

acmMetrics