Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                 ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
widMessage
 
        DWORD widMessage(uDeviceID, uMsg, dwUser, dwParam1, dwParam2)
 
        This user-supplied function is the entry point for a waveform
        input device driver.
 
Parameters
        UINT uDeviceID
            Specifies the ID of the target device.
 
        UINT uMsg
            Specifies the message being sent to the driver.
 
        DWORD dwUser
            For the WIDM_OPEN message,  The driver should
            fill this location with its instance data. For any other
            messages, the instance data is returned to the driver.
            Drivers supporting multiple clients can use this instance
            data to keep track of which client is associated with the
            message.
 
        DWORD dwParam1
            Specifies a message-dependent parameter.
 
        DWORD dwParam2
            Specifies a message-dependent parameter.
 
Return value
        Unless specified otherwise under a specific message, the driver
        should return an MMSYSERR_ or WAVERR_ error code.
 
Comments
        The driver should return MMSYSERR_NOTSUPPORTED if it does not
        support the specified message.
 
                                       -♦-