ACMDRIVERDETAILS 結構 (msacm.h)
ACMDRIVERDETAILS結構描述 ACM 驅動程式的功能。
語法
typedef struct tACMDRIVERDETAILS {
DWORD cbStruct;
FOURCC fccType;
FOURCC fccComp;
WORD wMid;
WORD wPid;
DWORD vdwACM;
DWORD vdwDriver;
DWORD fdwSupport;
DWORD cFormatTags;
DWORD cFilterTags;
HICON hicon;
char szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS];
char szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS];
char szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS];
char szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS];
char szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS];
} ACMDRIVERDETAILS, *PACMDRIVERDETAILS, *LPACMDRIVERDETAILS;
成員
cbStruct
ACMDRIVERDETAILS結構中包含的有效資訊大小,以位元組為單位。 應用程式應該將此成員初始化為所需資訊的大小,以位元組為單位。 此成員中指定的大小必須夠大,才能包含ACMDRIVERDETAILS結構的cbStruct成員。 當 acmDriverDetails 函式傳回時,此成員會包含傳回之資訊的實際大小。 傳回的資訊永遠不會超過要求的大小。
fccType
驅動程式的類型。 針對 ACM 驅動程式,請將此成員設定為 ACMDRIVERDETAILS_FCCTYPE_AUDIOCODEC。
fccComp
驅動程式的子類型。 此成員目前設定為ACMDRIVERDETAILS_FCCCOMP_UNDEFINED (零) 。
wMid
製造商識別碼。 製造商識別碼定義于 製造商和產品識別碼中。
wPid
產品識別碼。 產品識別碼定義于 製造商和產品識別碼中。
vdwACM
編譯此驅動程式的 ACM 版本。 版本號碼是0xAABBCCCC格式的十六進位數位,其中 AA 是主要版本號碼、BB 是次要版本號碼,而 CCCC 是組建編號。 版本元件 (主要、次要和組建) 應顯示為十進位數。
vdwDriver
驅動程式的版本。 版本號碼是0xAABBCCCC格式的十六進位數位,其中 AA 是主要版本號碼、BB 是次要版本號碼,而 CCCC 是組建編號。 版本元件 (主要、次要和組建) 應顯示為十進位數。
fdwSupport
驅動程式的支援旗標。 已定義下列值:
名稱 | 描述 |
---|---|
|
驅動程式支援非同步轉換。 |
|
驅動程式支援在兩個不同的格式標記之間進行轉換。 例如,如果驅動程式支援從WAVE_FORMAT_PCM壓縮到WAVE_FORMAT_ADPCM,則會設定此旗標。 |
|
驅動程式支援在相同格式標記的兩種不同格式之間進行轉換。 例如,如果驅動程式支援重新取樣WAVE_FORMAT_PCM,則會設定此旗標。 |
|
驅動程式已停用。 此旗標是由驅動程式的 ACM 設定,因為任何原因都已停用。 停用的驅動程式無法開啟,而且只能在非常有限的情況下使用。 |
|
驅動程式支援篩選 (修改資料,而不需要變更任何格式屬性) 。 例如,如果驅動程式支援WAVE_FORMAT_PCM上的磁片區或回應作業,則會設定此旗標。 |
|
驅動程式支援透過電壓音訊裝置的硬體輸入、輸出或兩者。 應用程式應該使用 acmMetrics 函式搭配ACM_METRIC_HARDWARE_WAVE_INPUT和ACM_METRIC_HARDWARE_WAVE_OUTPUT計量索引,以取得與支援 ACM 驅動程式相關聯的電壓音訊裝置識別碼。 |
|
驅動程式已在本機安裝,並符合目前的工作。 |
cFormatTags
此驅動程式支援的唯一格式標記數目。
cFilterTags
此驅動程式支援的唯一篩選標籤數目。
hicon
處理此驅動程式的自訂圖示。 應用程式可以使用此圖示,以視覺化方式參考驅動程式。 此成員可以是 Null。
szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS]
描述驅動程式名稱的 Null 終止字串。 此字串旨在以小空格顯示。
szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS]
描述驅動程式完整名稱的 Null 終止字串。 此字串旨在以大型 (描述性) 空格顯示。
szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS]
以 Null 結束的字串,提供驅動程式的著作權資訊。
szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS]
以 Null 結束的字串,提供驅動程式的特殊授權資訊。
szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS]
以 Null 結束的字串,提供驅動程式的特殊功能資訊。
需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
標頭 | msacm.h |