|
lineMakeCall
The lineMakeCall function places a call on the specified line to the specified destination
address. Optionally, call parameters can be specified if anything but default call
setup parameters are requested.
LONG lineMakeCall(
HLINE hLine,
|
| LPHCALL lphCall,
|
| LPCSTR lpszDestAddress,
|
| DWORD dwCountryCode,
|
| LPLINECALLPARAMS const lpCallParams
|
| );
|
|
Parameters
hLine
A handle to the open line device on which a call is to be originated.
lphCall
A pointer to an HCALL handle. The handle is only valid after the LINE_REPLY message is received by the application indicating that the lineMakeCall function successfully completed. Use this handle to identify the call when
invoking other telephony operations on the call. The application will initially
be the sole owner of this call. This handle is void if the function returns an
error (synchronously or asynchronously by the reply message).
lpszDestAddress
A pointer to the destination address. This follows the standard dialable
number format. This pointer can be NULL for non-dialed addresses (as with a hot
phone) or when all dialing will be performed using lineDial. In the latter case, lineMakeCall allocates an available call appearance that would typically remain in the dialtone state until dialing begins. Service providers that have inverse multiplexing
capabilities may allow an application to specify multiple addresses at once.
dwCountryCode
The country code of the called party. If a value of zero is specified, a
default is used by the implementation.
lpCallParams
A pointer to a LINECALLPARAMS structure. This structure allows the application to specify how it wants the
call to be set up. If NULL is specified, a default 3.1 kHz voice call is
established and an arbitrary origination address on the line is selected. This
structure allows the application to select elements such as the call's bearer mode,
data rate, expected media mode, origination address, blocking of caller ID
information, and dialing parameters.
Return Values
Returns a positive request ID if the function will be completed
asynchronously, or a negative error number if an error has occurred. The dwParam2 parameter of the corresponding LINE_REPLY message is zero if the function is successful or it is a negative error
number if an error has occurred. Possible return values are:
LINEERR_ADDRESSBLOCKED, LINEERR_INVALLINEHANDLE, LINEERR_BEARERMODEUNAVAIL,
LINEERR_INVALLINESTATE, LINEERR_CALLUNAVAIL, LINEERR_INVALMEDIAMODE,
LINEERR_DIALBILLING, LINEERR_INVALPARAM, LINEERR_DIALDIALTONE, LINEERR_INVALPOINTER,
LINEERR_DIALPROMPT, LINEERR_INVALRATE, LINEERR_DIALQUIET, LINEERR_NOMEM,
LINEERR_INUSE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_OPERATIONUNAVAIL,
LINEERR_INVALADDRESSID, LINEERR_RATEUNAVAIL, LINEERR_INVALADDRESSMODE,
LINEERR_RESOURCEUNAVAIL, LINEERR_INVALBEARERMODE, LINEERR_STRUCTURETOOSMALL,
LINEERR_INVALCALLPARAMS, LINEERR_UNINITIALIZED, LINEERR_INVALCOUNTRYCODE,
LINEERR_USERUSERINFOTOOBIG.
Remarks
If LINEERR_INVALLINESTATE is returned, the line is currently not in a state in
which this operation can be performed. A list of currently valid operations
can be found in the dwLineFeatures field (of the type LINEFEATURE_) in the LINEDEVSTATUS structure. Calling lineGetLineDevStatus updates the information in LINEDEVSTATUS. If LINEERR_DIALBILLING, LINEERR_DIALQUIET, LINEERR_DIALDIALTONE, or
LINEERR_DIALPROMPT is returned, none of the actions otherwise performed by lineMakeCall have occurred; for example, none of the dialable address prior to the
offending character has been dialed, no hookswitch state has changed, and so on.
After dialing has completed, several LINE_CALLSTATE messages are usually sent to the application to notify it about the progress
of the call. No generally valid sequence of call-state transitions is
specified, as no single fixed sequence of transitions can be guaranteed in practice. A
typical sequence may cause a call to transition from dialtone, dialing, proceeding, ringback, to connected. With non-dialed lines, the call may typically transition directly to connected state.
An application has the option to specify an originating address on the
specified line device. A service provider that models all stations on a switch as
addresses on a single line device allows the application to originate calls from
any of these stations using lineMakeCall.
The call parameters allow the application to make non-voice calls or request
special call setup options that are not available by default.
An application can partially dial using lineMakeCall and continue dialing using lineDial. To abandon a call attempt, use lineDrop.
After lineMakeCall returns a success reply message to the application, a LINE_CALLSTATE message
is sent to the application to indicate the current state of the call. This
state will not necessarily be LINECALLSTATE_DIALTONE.
See Also
LINE_CALLSTATE, LINE_REPLY, LINECALLPARAMS, LINEDEVSTATUS, lineDial, lineDrop, lineGetLineDevStatus
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Unix Manual Pages
|
