mciSetDriverData

BOOL APIENTRY
mciSetDriverData(
MCIDEVICEID
wDeviceID,
DWORD
dwData
);

The mciSetDriverData function is used for storing instance-specific information for an MCI driver.

Parameters

wDeviceID

Specifies a device ID.

dwData

Specifies the information to assign.

Return Value

Returns FALSE if the device ID is invalid. Otherwise returns TRUE.

Comments

Drivers can call mciSetDriverData to associate a driver-defined DWORD value with the current instance of the driver. Typically, an MCI driver calls this function while processing the MCI_OPEN_DRIVER message, specifying, for example, a pointer to an instance-specific data structure. The driver might call the function again when processing an MCI_CLOSE_DRIVER message, specifying a dwData value of zero. The driver can retrieve the stored value by calling mciGetDriverData.