PHONE_CLOSE (TAPI)

  • Article

This message is sent when an open phone device has been forcibly closed as part of resource reclamation. The device handle is no longer valid once this message has been sent.

PHONE_CLOSE
  hPhone = (HPHONE) hPhoneDevice;
  dwCallbackInstance = (DWORD) hCallback;
  dwParam1 = (DWORD) 0;
  dwParam2 = (DWORD) 0;
  dwParam3 = (DWORD) 0;

Parameters

  • hPhone
    Handle to the open phone device that was closed. The handle is no longer valid after this message has been sent.
  • dwCallbackInstance
    Application's callback instance that provided when opening the phone device.
  • dwParam1
    Not used by this message. Value is NULL.
  • dwParam2
    Not used by this message. Value is NULL.
  • dwParam3
    Not used by this message. Value is NULL.

Return Values

None.

Remarks

The PHONE_CLOSE message is only sent to an application after an open phone has been forcibly closed. This can be done to prevent a single application from monopolizing a phone device for too long. Whether the phone can be reopened immediately after a forced close is device specific.

An open phone device can also be forcibly closed after the user has modified the configuration of that phone or its driver. If the user wants the configuration changes to be effective immediately (as opposed to after the next system restart), and these changes affect the application's current view of the device (such as a change in device capabilities), then a service provider can forcibly close the phone device.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Tapi.h.

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.