widMessage

DWORD APIENTRY
    widMessage (
        UINT uDeviceId,
        UINT uMsg,
        DWORD dwUser,
        DWORD dwParam1,
        DWORD dwParam2
        );

The widMessage function is one of the user-mode audio driver entry points. It the entry point for user-mode waveform input drivers.

Parameters

uDeviceId

Device identifier (0, 1, 2, and so on) for the target device.

uMsg

Specifies one of the user-mode audio driver messages.

dwUser

Specifies a device instance identifier. For the WIDM_OPEN message, this is an output parameter. The driver creates the instance identifier and returns it in the address specified as the argument. For all other messages, this is an input parameter. The argument is the instance identifier.

dwParam1

Specifies the first message parameter. Dependent on message type.

dwParam2

Specifies the second message parameter. Dependent on message type.

Return Value

The widMessage function returns a value that is dependent upon the message. If the received message is not recognized, the function returns MMSYSERR_NOTSUPPORTED.

Comments

You can use dwUser in any manner you wish. Drivers that can support multiple clients return a different value for each WIDM_OPEN message, in order to keep track of which subsequent messages are being sent by which client.