共用方式為

OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS

  • 發行項

OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS OID 要求呼叫管理員或整合式通話管理員迷你埠 (MCM) 驅動程式，將 TAPI 呼叫參數轉譯為 NDIS 呼叫參數。 查詢此 OID 的用戶端會使用傳回的 NDIS 呼叫參數做為輸入 (格式化為 CO_CALL_PARAMETERS結構) 至用戶端放置撥出電話的 NdisClMakeCall。

此 OID 會使用CO_TAPI_TRANSLATE_TAPI_CALLPARAMS結構，其定義如下：

typedef struct _CO_TAPI_TRANSLATE_TAPI_CALLPARAMS {
    IN  ULONG               ulLineID;
    IN  ULONG               ulAddressID;
    IN  ULONG               ulFlags;
    IN  NDIS_VAR_DATA_DESC  DestAddress;
    IN  NDIS_VAR_DATA_DESC  LineCallParams;
    OUT NDIS_VAR_DATA_DESC  NdisCallParams;
} CO_TAPI_TRANSLATE_TAPI_CALLPARAMS, *PCO_TAPI_TRANSLATE_TAPI_CALLPARAMS;

此結構的成員包含下列資訊：

ulLineID
指定要導向撥出電話的以零起始的行識別碼。

ulAddressID
指定 由 ulLineID 所指定的行 (以零起始的位址識別碼，) 將導向撥出電話。

ulFlags
用戶端必須在 ulFlags中設定CO_TAPI_FLAG_OUTGOING_CALL位。 用戶端可以選擇性地在 ulFlags 中設定CO_TAPI_USE_DEFAULT_CALLPARAMS位，以要求呼叫管理員或 MCM 驅動程式忽略 LineCallParams ，並傳回裝置的預設 NDIS 呼叫參數。

DestAddress
指定 NDIS_VAR_DATA_DESC 結構，其中包含從NDIS_VAR_DATA_DESC結構的開頭到格式化為字元陣列之目的地位址的位移。 NDIS_VAR_DATA_DESC 結構也包含目的地位址的長度。 目的地位址是撥出電話將導向的目標位址。

LineCallParams
指定 NDIS_VAR_DATA_DESC 結構，其中包含從NDIS_VAR_DATA_DESC結構開頭到LINE_CALL_PARAMS結構的位移。 NDIS_VAR_DATA_DESC 結構也包含LINE_CALL_PARAMS結構的長度。 LINE_CALL_PARAMS 結構會指定要轉譯為 NDIS 呼叫參數的 TAPI 呼叫參數。 如需LINE_CALL_PARAMS結構的詳細資訊，請參閱 Microsoft Windows SDK 和 ndistapi.h 標頭檔。

NdisCallParams
指定 NDIS_VAR_DATA_DESC 結構，其中包含從NDIS_VAR_DATA_DESC結構開頭到CO_CALL_PARAMETERS結構的位移。 NDIS_VAR_DATA_DESC 結構也包含 CO_CALL_PARAMETERS 結構的長度。 CO_CALL_PARAMETERS 結構會指定已轉譯指定 TAPI 呼叫參數的 NDIS 呼叫參數。

備註

如果要求成功，呼叫管理員或 MCM 驅動程式會填入 NdisCallParams 所參考的CO_CALL_PARAMETERS結構與已轉譯的 NDIS 呼叫參數。 呼叫管理員或 MCM 驅動程式必須在 NdisCallParams所參考的一般記憶體區段中配置CO_CALL_PARAMETERS結構。 用戶端會將CO_CALL_PARAMETERS結構的總長度寫入 NdisCallParams.Length。

如果用戶端在 ulFlags中設定CO_TAPI_USE_DEFAULT_CALLPARAMS位，則用戶端不會指定 TAPI 呼叫參數。 在此情況下，呼叫管理員或 MCM 驅動程式應該會傳回裝置的預設 NDIS 呼叫參數。 如果裝置沒有預設的 NDIS 呼叫參數，呼叫管理員或 MCM 驅動程式應該會傳回NDIS_STATUS_FAILURE。

規格需求

版本：Windows Vista 和更新版本 標頭：Ntddndis.h (包含 Ndis.h)