PHONE_CREATE

The TAPI PHONE_CREATE message is sent to inform applications of the creation of a new phone device.

PHONE_CREATE
hPhone = (HPHONE) hPhoneDev;
dwCallbackInstance = (DWORD) 0;
dwParam1 = (DWORD) idDevice;
dwParam2 = (DWORD) 0;
dwParam3 = (DWORD) 0;

Parameters

hPhone

Unused.

dwCallbackInstance

Unused.

dwParam1

The hDeviceID of the newly created device.

dwParam2

Unused.

dwParam3

Unused.

Return Values

No return value.

Remarks

Applications that negotiated API version 1.3 are sent a PHONE_STATE message specifying PHONESTATE_REINIT, which requires them to shut down their use of the API and call phoneInitialize again to obtain the new number of devices. However, TAPI version 1.4 and above do not require all applications to shut down before allowing applications to reinitialize; reinitialization can take place immediately when a new device is created.

Applications supporting TAPI version 1.4 or later are sent a PHONE_CREATE message. This informs them of the existence of the new device and its new device identifier. The application can then choose whether or not to attempt working with the new device at its leisure.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later.
  Version: Requires TAPI 2.0 or later.
  Header: Declared in Tapi.h.

See Also

PHONE_STATE, phoneInitialize, phoneInitializeEx