function queries a specified line device to determine its telephony
capabilities. The returned information is valid for all addresses on the line device.
| HLINEAPP hLineApp,
| DWORD dwDeviceID,
| DWORD dwAPIVersion,
| DWORD dwExtVersion,
| LPLINEDEVCAPS lpLineDevCaps
The handle to the application's registration with TAPI.
The line device to be queried.
The version number of the Telephony API to be used. The high-order word
contains the major version number; the low-order word contains the minor version
number. This number is obtained by lineNegotiateAPIVersion
The version number of the service provider-specific extensions to be used.
This number is obtained by lineNegotiateExtVersion
. It can be left zero if no device-specific extensions are to be used.
Otherwise, the high-order word contains the major version number; the low-order word
contains the minor version number.
A pointer to a variably sized structure of type LINEDEVCAPS
. Upon successful completion of the request, this structure is filled with
line device capabilities information. Prior to calling lineGetDevCaps
, the application should set the dwTotalSize
field of this structure to indicate the amount of memory available to TAPI
for returning information.
Returns zero if the request is successful or a negative error number if an
error has occurred. Possible return values are:
LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION,
LINEERR_OPERATIONFAILED, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_RESOURCEUNAVAIL,
LINEERR_INVALAPPHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER,
LINEERR_UNINITIALIZED, LINEERR_NODRIVER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.
Before using lineGetDevCaps
, the application must negotiate the API version number to use, and, if
desired, the extension version to use.
The API and extension version numbers are those under which TAPI and the
service provider must operate. If version ranges do not overlap, the application,
API, or service-provider versions are incompatible and an error is returned.
One of the fields in the LINEDEVCAPS
structure returned by this function contains the number of addresses assigned
to the specified line device. The actual address IDs used to reference
individual addresses vary from zero to one less than the returned number. The
capabilities of each address may be different. Use lineGetAddressCaps
for each available <dwDeviceID
> combination to determine the exact capabilities of each address.
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages