共用方式為

NdisCoGetTapiCallId 函式 (ndis.h)

  • 發行項

NdisCoGetTapiCallId 會擷取TAPI應用程式可用來識別特定 NDIS 虛擬連線 (VC) 的字串。

語法

NDIS_STATUS NdisCoGetTapiCallId(
  [in]      NDIS_HANDLE NdisVcHandle,
  [in, out] PVAR_STRING TapiCallId
);

參數

[in] NdisVcHandle

指定 VC 的 NDIS 句柄。 當 VC 最初是使用 NdisCoCreateVc 函式建立時，NDIS 會提供此句柄。

[in, out] TapiCallId

呼叫端配置的緩衝區指標，該緩衝區會接收類型為 VAR_STRING 的數據結構。 成功傳回時，此結構描述TAPI應用程式可用來識別 VC 的字串。

傳回值

傳回下列其中一個狀態值：

傳回碼 Description
NDIS_STATUS_SUCCESS
 NDIS 已成功傳回 VC 的字串標識碼。
NDIS_STATUS_BUFFER_TOO_SHORT
 VAR_STRING 結構的 ulTotalSize 成員指定緩衝區的大小不足以保存識別 VC 的字串。 NdisCoGetTapiCallId 會將 VAR_STRING 結構的 ulNeededSize 成員設定為所需的位元元組大小。
NDIS_STATUS_INVALID_DATA
 NdisVcHandle 所指定的 VC 句柄無效。

備註

假設通話管理員呼叫 NdisCoCreateVc 來建立 TAPI 通話的 VC。 NDIS 接著會將 VC 的句柄提供給用戶端。 用戶端會在 對 NdisCoGetTapiCallId 函式的呼叫中傳遞這個 VC 句柄，以擷取識別 VC 的字串。 用戶端可以將此字串標識碼傳遞至 TAPI 應用程式，以識別 VC。

用戶端會為其管理的每個 VC 建立內容。 用戶端會使用 NdisCoGetTapiCallId 來擷取每個 VC 的字串標識符。 用戶端會將每個字串標識碼傳遞至 TAPI 應用程式，以識別每個 VC。 之後，如果 TAPI 應用程式在 VC 相關作業中將其中一個字串標識碼向下傳遞至用戶端，客戶端必須在呼叫中將此字串標識子當做 Unicode 字串傳遞 NdisClGetProtocolVcContextFromTapiCallId 以取得 VC 的正確內容。

如需VAR_STRING結構的詳細資訊，請參閱 TAPI 物件。

規格需求

需求 值
最低支援的用戶端 支援 NDIS 6.0 和 NDIS 5.1 驅動程式 (請參閱 Windows Vista 中的 NdisCoGetTapiCallId (NDIS 5.1) ) 。 (支援 NDIS 5.1 驅動程式，請參閱 Windows XP 中的 NdisCoGetTapiCallId (NDIS 5.1) ) 。
目標平台 桌面
標頭 ndis.h (包含 Ndis.h)
程式庫 Ndis.lib
IRQL DISPATCH_LEVEL
DDI 合規性規則 Irql_Connection_Function (ndis)

另請參閱

NdisClGetProtocolVcContextFromTapiCallId

NdisCoCreateVc