NdisClGetProtocolVcContextFromTapiCallId 函式 (ndis.h)

NdisClGetProtocolVcContextFromTapiCallId 會擷取由TAPI通話標識符字串識別的虛擬連線 (VC) 的客戶端內容。

語法

NDIS_STATUS NdisClGetProtocolVcContextFromTapiCallId(
  [in]  UNICODE_STRING TapiCallId,
  [out] PNDIS_HANDLE   ProtocolVcContext
);

參數

[in] TapiCallId

識別特定 VC 的 Unicode 字串。 此字串是先前由 NdisCoGetTapiCallID 函式傳回的字串標識碼 Unicode 版本。

[out] ProtocolVcContext

呼叫端配置的NDIS_HANDLE指標，可接收 VC 用戶端內容的句柄。 用戶端從其 ProtocolCoCreateVc 處理程式傳回時，將此內容提供給 NDIS。

傳回值

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

傳回碼	Description
NDIS_STATUS_SUCCESS	NDIS 已成功擷取TAPI呼叫標識符字串所識別之 VC 的用戶端 VC 內容句柄。
NDIS_STATUS_FAILURE	嘗試擷取用戶端 VC 內容的句柄失敗。

備註

假設通話管理員呼叫 NdisCoCreateVc 來建立 TAPI 呼叫的 VC。 NDIS 接著會將 VC 的句柄提供給用戶端。 用戶端會在對 NdisCoGetTapiCallId 函式的呼叫中傳遞這個 VC 句柄，以擷取 VC 的字串標識碼。 然後，用戶端可以將此標識符顯示為 Unicode 字串給 NdisClGetProtocolVcContextFromTapiCallId ，以取得 VC 的內容。

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

如需詳細資訊，請參閱 UNICODE_STRING 結構。

規格需求

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

另請參閱

NdisCoCreateVc

NdisCoGetTapiCallId

UNICODE_STRING