ACMDRIVERDETAILS

The ACMDRIVERDETAILS structure describes the features of an ACM driver.

typedef struct { 
  DWORD  cbStruct; 
  FOURCC fccType; 
  FOURCC fccComp; 
  WORD   wMid; 
  WORD   wPid; 
  DWORD  vdwACM; 
  DWORD  vdwDriver; 
  DWORD  fdwSupport; 
  DWORD  cFormatTags; 
  DWORD  cFilterTags; 
  HICON  hicon; 
  TCHAR  szShortName[ACMDRIVERDETAILS_SHORTNAME_CHARS]; 
  TCHAR  szLongName[ACMDRIVERDETAILS_LONGNAME_CHARS]; 
  TCHAR  szCopyright[ACMDRIVERDETAILS_COPYRIGHT_CHARS]; 
  TCHAR  szLicensing[ACMDRIVERDETAILS_LICENSING_CHARS]; 
  TCHAR  szFeatures[ACMDRIVERDETAILS_FEATURES_CHARS]; 
} ACMDRIVERDETAILS; 
 

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:

ACMDRIVERDETAILS_SUPPORTF_ASYNC

Driver supports asynchronous conversions.

ACMDRIVERDETAILS_SUPPORTF_CODEC

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.

ACMDRIVERDETAILS_SUPPORTF_CONVERTER

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.

ACMDRIVERDETAILS_SUPPORTF_DISABLED

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.

ACMDRIVERDETAILS_SUPPORTF_FILTER

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.

ACMDRIVERDETAILS_SUPPORTF_HARDWARE

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.

ACMDRIVERDETAILS_SUPPORTF_LOCAL

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

Null-terminated string that describes the name of the driver. This string is intended to be displayed in small spaces.

szLongName

Null-terminated string that describes the full name of the driver. This string is intended to be displayed in large (descriptive) spaces.

szCopyright

Null-terminated string that provides copyright information for the driver.

szLicensing

Null-terminated string that provides special licensing information for the driver.

szFeatures

Null-terminated string that provides special feature information for the driver.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Msacm.h.
**  Unicode:** Declared as Unicode and ANSI structures.

See Also

Audio Compression Manager, Audio Compression Structures, acmDriverDetails, acmMetrics