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 結構相同。 此成員可能是下列值的一些組合,並參考驅動程式使用格式標籤所支援的作業:
名稱 | 描述 |
---|---|
|
驅動程式支援使用指定的格式標記進行非同步轉換。 |
|
驅動程式支援在兩個不同的格式標記之間進行轉換,其中其中一個標記是指定的格式標記。 例如,如果驅動程式支援從WAVE_FORMAT_PCM壓縮到WAVE_FORMAT_ADPCM,則會設定此旗標。 |
|
驅動程式支援在兩種不同格式的指定格式標記之間進行轉換。 例如,如果驅動程式支援重新取樣WAVE_FORMAT_PCM,則會設定此旗標。 |
|
驅動程式支援篩選 (修改資料,而不需要變更任何格式屬性) 。 例如,如果驅動程式支援指定格式標籤上的磁片區或回應作業,則會設定此旗標。 |
|
驅動程式透過電壓音訊裝置支援硬體輸入、輸出或兩者指定的格式標記。 應用程式應該使用 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 |