Creating a DriverProc Function - Win32 Multimedia Programmer's Reference

Custom Search

Creating a DriverProc Function

You create a DriverProc function in much the same way as you create a window procedure. The function consists of a switch statement, and each case processes a given driver message, returning a value indicating success or failure. The DriverProc function has the following form:

LONG DriverProc(DWORD dwDriverId, HDRVR hdrvr, UINT msg,
LONG lParam1, LONG lParam2)
{
DWORD dwRes = 0L;

switch (msg) {
case DRV_LOAD:
// Sent when the driver is loaded. This is always
// the first message received by a driver.
dwRes = 1L; // returns 0L to fail
break;

case DRV_FREE:
// Sent when the driver is about to be discarded.
// This is the last message a driver receives
// before it is freed.
dwRes = 1L; // return value ignored
break;

case DRV_OPEN:
// Sent when the driver is opened.
dwRes = 1L; // returns 0L to fail
break; // value subsequently used
// for dwDriverId.

case DRV_CLOSE:
// Sent when the driver is closed. Drivers are
// unloaded when the open count reaches zero.
dwRes = 1L; // returns 0L to fail
break;

case DRV_ENABLE:
// Sent when the driver is loaded or reloaded and
// when Windows is enabled. Install interrupt
// handlers and initialize hardware. Expect the
// driver to be in memory only between the enable
// and disable messages.
dwRes = 1L; // return value ignored
break;

case DRV_DISABLE:
// Sent before the driver is freed or when Windows
// is disabled. Remove interrupt handlers and place
// hardware in an inactive state.
dwRes = 1L; // return value ignored
break;

case DRV_INSTALL:
// Sent when the driver is installed.
dwRes = DRVCNF_OK; // Can also return
break; // DRVCNF_CANCEL
// and DRV_RESTART

case DRV_REMOVE:
// Sent when the driver is removed.
dwRes = 1L; // return value ignored
break;

case DRV_QUERYCONFIGURE:
// Sent to determine if the driver can be
// configured.
dwRes = 0L; // Zero indicates configuration
break; // NOT supported

case DRV_CONFIGURE:
// Sent to display the configuration
// dialog box for the driver.
dwRes = DRVCNF_OK; // Can also return
break; // DRVCNF_CANCEL
// and DRVCNF_RESTART

default:
// Process any other messages.
return DefDriverProc (dwDriverId, hdrvr,
msg, lParam1, lParam2);

}
return dwRes;
}

Last news from Greatis Software

    Nostalgia .Net     .Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More »

Recommended software for developers

    Ultimate Pack     Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More »

    Form Designer .Net     Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More »

    Print Suite .Net     Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More »

    Gradient Controls .Net     Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More »

    Greatis iGrid     iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More »

All the contacts and projects

Dmitry Vasiliev (just.dmitry)

More Online Helps

Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages

greatis just4fun network