Microsoft Windows CE 3.0  

ACMDM_DRIVER_ABOUT

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This message requests an ACM driver to display its Aboutdialog box.

Parameters

dwDriverID
Specifies a driver instance identifier. The driver returns this value in response to the ACM_Openfunction.
hDriver
Handle to a driver.
uMsg
Specifies this message.
lParam1
Contains a validated window handle, which the driver should use to specify the parent window for the Aboutdialog box. The value also can be –1L.
lParam2
Not used.

Return Values

MMSYSERR_NOERROR indicates success. Otherwise, the driver returns one of the MMSYSERR error values declared in the Mmsystem.h header file or one of the ACMERR error values declared in the Msacm.h header file. If the driver does not provide an Aboutdialog box, it returns MMSYSERR_NOTSUPPORTED.

Remarks

The ACM (Waveapi.dll) sends this message by calling the ACM driver's ACM_IOControlfunction entry point through the DeviceIoControlfunction.

If an ACM driver provides an Aboutdialog box, it displays the box in response to this message. If an ACM driver does not provide an Aboutdialog box, it returns MMSYSERR_NOTSUPPORTED. In the latter case, the ACM displays a default Aboutdialog box.

However, if lParam1is –1L, the driver does not display its Aboutdialog box. Instead, it returns MMSYSERR_NOERROR if it provides an Aboutdialog box and MMSYSERR_NOTSUPPORTED if it does not provide an Aboutdialog box.

For more information, see the Microsoft Windows NT DDK.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later      
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.


 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.