Adding Custom Error Strings to an MCI Device Driver

• Microsoft Windows Software Development Kit (SDK) versions 3.0, 3.1
• Microsoft Win32 Software Development Kit (SDK), versions 3.5, 3.51, 4.0

SUMMARY

In the Microsoft Windows graphical environment, an application can use mciGetErrorString() to obtain the string associated with an error code returned from a media control interface (MCI) device driver.

An MCI driver can use a STRINGTABLE resource to store its error strings. The identifier constant for each string should correspond to the error value returned by the DriverProc function. This value must be greater than or equal to the constant MCIERR_CUSTOM_DRIVER_BASE to avoid confusion with the predefined MCI error codes.

MORE INFORMATION

For example, the Pioneer LaserDisc device driver, MCIPIONR.DRV, included with the Microsoft Device Development Kit (DDK) for Windows 3.1, contains the following declarations in its header file, MCIPIONR.H:

#define MCIERR_PIONEER_ILLEGAL_FOR_CLV  (MCIERR_CUSTOM_DRIVER_BASE)
#define MCIERR_PIONEER_NOT_SPINNING     (MCIERR_CUSTOM_DRIVER_BASE+1)
#define MCIERR_PIONEER_NO_CHAPTERS      (MCIERR_CUSTOM_DRIVER_BASE+2)
#define MCIERR_PIONEER_NO_TIMERS        (MCIERR_CUSTOM_DRIVER_BASE+3) 

STRINGTABLE
BEGIN
  MCIERR_PIONEER_ILLEGAL_FOR_CLV, "Illegal operation for CLV type disc."
  MCIERR_PIONEER_NOT_SPINNING, "The disc must be spun up to perform this \ operation."
  MCIERR_PIONEER_NO_CHAPTERS, "Chapters are not supported for this disc."
  MCIERR_PIONEER_NO_TIMERS, "All timers are in use. Cannot enable \ notification."
END 

Additional query words: 3.00 3.10 3.50 4.00 95 win16sdk

Keywords :
Version :
Platform :
Issue type :