lineDevSpecific
The
lineDevSpecific function enables service providers to provide access to features not offered
by other TAPI functions. The meaning of the extensions are device specific, and
taking advantage of these extensions requires the application to be fully
aware of them.
LONG lineDevSpecific(
HLINE hLine,
|
|
DWORD dwAddressID,
|
|
HCALL hCall,
|
|
LPVOID lpParams,
|
|
DWORD dwSize
|
|
);
|
|
Parameters
hLine
A handle to a line device. This parameter is required.
dwAddressID
An address ID on the given line device.
hCall
A handle to a call. This parameter is optional, but if it is specified, the
call it represents must belong to the
hLine line device. The call state of
hCall is device specific.
lpParams
A pointer to a memory area used to hold a parameter block. The format of this
parameter block is device specific and its contents are passed by TAPI to or
from the service provider.
dwSize
The size in bytes of the parameter block area.
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_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE,
LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL,
LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.
Additional return values are device specific.
Remarks
This operation is part of the Extended Telephony services. It provides access
to a device-specific feature without defining its meaning. This operation is
only available if the application has successfully negotiated a device-specific
extension version.
This function provides a generic parameter profile. The interpretation of the
parameter structure is device specific. Whether
dwAddressID and/or
hCall are expected to be valid is device-specific. If specified, they must belong
to
hLine. Indications and replies sent back the application that are device specific
should use the
LINE_DEVSPECIFIC message.
A service provider can provide access to device-specific functions by defining
parameters for use with this function. Applications that want to make use of
these device-specific extensions should consult the device-specific (in this
case, vendor-specific) documentation that describes what extensions are defined.
An application that relies on these device-specific extensions will typically
not be able to work with other service provider environments.
See Also
LINE_DEVSPECIFIC,
LINE_REPLY
- Software for developers
-
Delphi Components
.Net Components
Software for Android Developers
- More information resources
-
MegaDetailed.Net
Unix Manual Pages
Delphi Examples
- Databases for Amazon shops developers
-
Amazon Categories Database
Browse Nodes Database
