ACMFILTERDETAILS 結構 (msacm.h)

發行項
08/24/2023

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

語法

typedef struct tACMFILTERDETAILS {
  DWORD        cbStruct;
  DWORD        dwFilterIndex;
  DWORD        dwFilterTag;
  DWORD        fdwSupport;
  LPWAVEFILTER pwfltr;
  DWORD        cbwfltr;
  char         szFilter[ACMFILTERDETAILS_FILTER_CHARS];
} ACMFILTERDETAILS, *PACMFILTERDETAILS, *LPACMFILTERDETAILS;

成員

cbStruct

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

dwFilterIndex

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

dwFilterTag

ACMFILTERDETAILS結構描述的波聲音訊篩選標記。這個成員會當做ACM_FILTERDETAILSF_INDEX查詢旗標的輸入使用。針對ACM_FILTERDETAILSF_FORMAT查詢旗標，此成員必須初始化為 與 pwfltr 成員指定的相同篩選標籤。如果 acmFilterDetails 函式成功，則一律會傳回這個成員。此成員應設定為所有其他查詢旗標WAVE_FILTER_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 驅動程式相關聯的波音訊裝置識別碼。

pwfltr

將接收篩選詳細資料的 WAVEFILTER 結構的指標。除非使用 acmFilterDetails 函式指定ACM_FILTERDETAILSF_FILTER旗標，否則此結構不需要應用程式初始化。在此情況下，WAVEFILTER結構的dwFilterTag成員必須等於ACMFILTERDETAILS結構的dwFilterTag成員。

cbwfltr

大小，以位元組為單位，可供 pwfltr 接收篩選詳細資料。 acmMetrics和acmFilterTagDetails函式可用來判斷指定驅動程式 (或所有已安裝 ACM 驅動程式所需的最大大小) 。

szFilter[ACMFILTERDETAILS_FILTER_CHARS]

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

需求


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