ACMDRIVERDETAILS structure (msacm.h)
The ACMDRIVERDETAILS structure describes the features of an ACM driver.
Syntax
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;
Members
cbStruct
Size, in bytes, of the valid information contained in the ACMDRIVERDETAILS structure. An application should initialize this member to the size, in bytes, of the desired information. The size specified in this member must be large enough to contain the cbStruct member of the ACMDRIVERDETAILS structure. When the acmDriverDetails function returns, this member contains the actual size of the information returned. The returned information will never exceed the requested size.
fccType
Type of the driver. For ACM drivers, set this member to ACMDRIVERDETAILS_FCCTYPE_AUDIOCODEC.
fccComp
Subtype of the driver. This member is currently set to ACMDRIVERDETAILS_FCCCOMP_UNDEFINED (zero).
wMid
Manufacturer identifier. Manufacturer identifiers are defined in Manufacturer and Product Identifiers.
wPid
Product identifier. Product identifiers are defined in Manufacturer and Product Identifiers.
vdwACM
Version of the ACM for which this driver was compiled. The version number is a hexadecimal number in the format 0xAABBCCCC, where AA is the major version number, BB is the minor version number, and CCCC is the build number. The version parts (major, minor, and build) should be displayed as decimal numbers.
vdwDriver
Version of the driver. The version number is a hexadecimal number in the format 0xAABBCCCC, where AA is the major version number, BB is the minor version number, and CCCC is the build number. The version parts (major, minor, and build) should be displayed as decimal numbers.
fdwSupport
Support flags for the driver. The following values are defined:
| Name | Description |
|---|---|
|
Driver supports asynchronous conversions. |
|
Driver supports conversion between two different format tags. For example, if a driver supports compression from WAVE_FORMAT_PCM to WAVE_FORMAT_ADPCM, this flag is set. |
|
Driver supports conversion between two different formats of the same format tag. For example, if a driver supports resampling of WAVE_FORMAT_PCM, this flag is set. |
|
Driver has been disabled. This flag is set by the ACM for a driver when it has been disabled for any of a number of reasons. Disabled drivers cannot be opened and can be used only under very limited circumstances. |
|
Driver supports a filter (modification of the data without changing any of the format attributes). For example, if a driver supports volume or echo operations on WAVE_FORMAT_PCM, this flag is set. |
|
Driver supports hardware input, output, or both through a waveform-audio device. An application should use the acmMetrics function with the ACM_METRIC_HARDWARE_WAVE_INPUT and ACM_METRIC_HARDWARE_WAVE_OUTPUT metric indexes to get the waveform-audio device identifiers associated with the supporting ACM driver. |
|
The driver has been installed locally with respect to the current task. |
cFormatTags
Number of unique format tags supported by this driver.
cFilterTags
Number of unique filter tags supported by this driver.
hicon
Handle to a custom icon for this driver. An application can use this icon for referencing the driver visually. This member can be NULL.
szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS]
Null-terminated string that describes the name of the driver. This string is intended to be displayed in small spaces.
szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS]
Null-terminated string that describes the full name of the driver. This string is intended to be displayed in large (descriptive) spaces.
szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS]
Null-terminated string that provides copyright information for the driver.
szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS]
Null-terminated string that provides special licensing information for the driver.
szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS]
Null-terminated string that provides special feature information for the driver.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Header | msacm.h |