Share via

AUDCAP_INFO

  • Article

Use this AUDIO capabilities information structure for both input and output when calling capability APIs. The members are input-only, output-only, or input/output (I/O), depending on the API used. Behavior is undefined if these are altered.

typedef struct {
  WORD             wFormatTag;
  AUDIO_FORMAT_ID  Id;
  char             szFormat[ACMFORMATDETAILS_FORMAT_CHARS];
  UINT             uMaxBitrate;
  UINT             uAvgBitrate;
  WORD             wCPUUtilizationEncode;
  WORD             wCPUUtilizationDecode;
  BOOL             bSendEnabled;
  BOOL             bRecvEnabled;
  WORD             wSortIndex;
} AUDCAP_INFO;

Elements

  • wFormatTag
    ACM format tag.
  • Id
    (Output-only) Local identification (a.k.a. *Handle*) of this capability entry.
  • szFormat[ACMFORMATDETAILS_FORMAT_CHARS]
    (Output-only) Descriptive string of the format; for example, "Microsoft GSM 6.10".
  • uMaxBitrate
    (Output-only) Worst-case bit rate (maximum rate of data transfer).
  • uAvgBitrate
    Average bit rate for this codec.
  • wCPUUtilizationEncode
    Percent utilization of Pentium 90 megahertz (MHz) needed for compression.
  • wCPUUtilizationDecode
    Percent utilization of Pentium 90 MHz needed for decompression.
  • bSendEnabled
    OK to use this format for sending.
  • bRecvEnabled
    OK to use this format for receiving.
  • wSortIndex
    Ordered position of this entry in the capability table. Can be used as input only in the IInstallAudioCodecs::ReorderFormats method.

Requirements

**  Windows NT/2000:** Requires Windows NT 4.0 SP3 or later.
**  Windows 95/98:** Requires Windows 95 or later. Available as a redistributable for Windows 95.
**  Header:** Declared in Appavcap.h.

See Also

AUDCAP_INFO_LIST