共用方式為

ACMFILTERTAGDETAILS 結構 (msacm.h)

  • 發行項

ACMFILTERTAGDETAILS結構詳細說明 ACM 篩選驅動程式的電壓音訊篩選標籤。

語法

typedef struct tACMFILTERTAGDETAILS {
  DWORD cbStruct;
  DWORD dwFilterTagIndex;
  DWORD dwFilterTag;
  DWORD cbFilterSize;
  DWORD fdwSupport;
  DWORD cStandardFilters;
  char  szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS];
} ACMFILTERTAGDETAILS, *PACMFILTERTAGDETAILS, *LPACMFILTERTAGDETAILS;

成員

cbStruct

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

dwFilterTagIndex

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

dwFilterTag

ACMFILTERTAGDETAILS結構描述的波音訊篩選標記。 此成員會作為ACM_FILTERTAGDETAILSF_FILTERTAG和ACM_FILTERTAGDETAILSF_LARGESTSIZE查詢旗標的輸入。 如果 acmFilterTagDetails 函 式成功，則一律會傳回這個成員。 這個成員應該設定為所有其他查詢旗標的WAVE_FILTER_UNKNOWN。

cbFilterSize

dwFilterTag類型之電壓音訊篩選的最大大小，以位元組為單位。 例如，此成員會是 40，WAVE_FILTER_ECHO為 36，而WAVE_FILTER_VOLUME則為 36。

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 驅動程式相關聯的電壓音訊裝置識別碼。

cStandardFilters

dwFilterTag類型 (的標準篩選數目，也就是所有篩選特性) 的組合。 這個值無法指定驅動程式支援的所有篩選。

szFilterTag[ACMFILTERTAGDETAILS_FILTERTAG_CHARS]

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

需求

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

另請參閱

ACMDRIVERDETAILS

音訊壓縮管理員

音訊壓縮結構

acmFilterTagDetails

acmFilterTagEnum