TSPI_providerCreatePhoneDevice (Compact 2013)

3/26/2014

This function is called by TAPI in response to the receipt of a system plug-and-play notification of a new device associated with the TSP.

Syntax

LONG TSPIAPI TSPI_providerCreatePhoneDevice(
  HKEY hActive, 
  LPCWSTR szDevKey, 
  LPCWSTR szDevName
);

Parameters

  • hActive
    Handle to the open registry key for the active instance of the device key.
  • szDevKey
    Registry path string to the device key.
  • szDevName
    New name of the device, for example COM2.

Return Value

Returns zero if the request succeeds or an error number if an error occurs. The following table shows the return values for this method.

Value

Description

LINEERR_BADDEVICEID

The device id is incorrect.

LINEERR_NOMEM

Not enough memory is available.

LINEERR_OPERATIONFAILED

The operation failed.

Remarks

TAPI calls the TSPI-provider CreatePhoneDevice when it receives a plug-and-play system notification that a new device, which is associated with the TSP, has been added to the system. This association is indicated in the registry key of the new device. If the TSP chooses to create a phone device, it should also send a PHONE_CREATE message to TAPI.

Requirements

Header

tspi.h

Library

CellTSP.dll

See Also

Reference

TSPI Service Provider Functions