SendDriverMessage function

Sends the specified message to the installable driver.

Syntax

LRESULT WINAPI SendDriverMessage(
  _In_    HDRVR  hdrvr,
  _In_    UINT   msg,
  _Inout_ LPARAM lParam1,
  _Inout_ LPARAM lParam2
);

Parameters

  • hdrvr [in]
    Handle of the installable driver instance. The handle must been previously created by using the OpenDriver function.

  • msg [in]
    Driver message value. It can be a custom message value or one of these standard message values.

    Value Meaning
    DRV_QUERYCONFIGURE

    Queries an installable driver about whether it supports the DRV_CONFIGURE message and can display a configuration dialog box.

    DRV_CONFIGURE

    Notifies an installable driver that it should display a configuration dialog box. (This message should only be sent if the driver returns a nonzero value when the DRV_QUERYCONFIGURE message is processed.)

    DRV_INSTALL

    Notifies an installable driver that it has been successfully installed.

    DRV_REMOVE

    Notifies an installable driver that it is about to be removed from the system.

     

  • lParam1 [in, out]
    32-bit message-dependent information.

  • lParam2 [in, out]
    32-bit message-dependent information.

Return value

Returns nonzero if successful or zero otherwise.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Version

Installable Drivers, Installable Driver Functions

Header

Mmsystem.h (include Windows.h)

Library

Winmm.lib

DLL

Winmm.dll

See also

Installable Drivers

Installable Driver Functions