TSPI_lineGetAddressCaps函式 (tspi.h)
TSPI_lineGetAddressCaps函式會查詢指定線路裝置上的指定位址，以判斷其電話語音功能。
語法
LONG TSPIAPI TSPI_lineGetAddressCaps(
DWORD dwDeviceID,
DWORD dwAddressID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPLINEADDRESSCAPS lpAddressCaps
);
參數
dwDeviceID
包含要查詢之位址的行裝置。
dwAddressID
要查詢其功能之指定行裝置上的位址。 位址標識符永久與地址相關聯;標識碼在操作系統升級之間維持不變。 呼叫此函式時，TAPI 不會驗證此參數。
dwTSPIVersion
要使用的 Telephony SPI 版本號碼。 高序字包含主要版本號碼;低序字包含次要版本號碼。
dwExtVersion
要使用的服務提供者特定擴充功能版本號碼。 如果未使用任何裝置特定的擴充功能，則此數位為零。 否則，高序字包含主要版本號碼;低序字包含次要版本號碼。 呼叫此函式時，TAPI 不會驗證此參數。
lpAddressCaps
LINEADDRESSCAPS 類型的可變大小結構的指標。 成功完成要求時，此結構會填入位址功能資訊。
傳回值
如果函式成功或發生錯誤，則傳回零。 可能的傳回值如下所示：
LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_NOMEM、LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALADDRESSID、LINEERR_OPERATIONFAILED、LINEERR_NODRIVER LINEERR_RESOURCEUNAVAIL。
備註
特定驅動程式支援的行裝置標識碼會循序編號，從傳遞至 TSPI_providerInit 函式的 dwLineDeviceIDBase 值開始。
服務提供者會填入 LINEADDRESSCAPS 數據結構的所有成員，但 TAPI 填入的 dwTotalSize 除外。 服務提供者不得覆寫 dwTotalSize 成員。
服務提供者從 TSPI_lineGetAddressCaps 函式傳回之後，TAPI 會設定 LINEADDRESSCAPS 結構的 dwCallInfoStates 和 dwCallStates 成員，如下所示：
LINEADDRESSCAPS.dwCallInfoStates |=
LINECALLINFOSTATE_NUMOWNERINCR |
LINECALLINFOSTATE_NUMOWNERDECR |
LINECALLINFOSTATE_NUMMONITORS;
LINEADDRESSCAPS.dwCallStates |= LINECALLSTATE_UNKNOWN;
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tspi.h |