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; 
    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;

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 of 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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in msacm.h.
  Import Library: Use msacm32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

ACMDRIVERDETAILS

Members

QuickInfo

See Also