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;

規格需求

另請參閱

LINEADDRESSCAPS

TSPI_providerInit