NdisClGetProtocolVcContextFromTapiCallId 函式 (ndis.h)
NdisClGetProtocolVcContextFromTapiCallId 擷取 TAPI 通話識別符字串所識別之虛擬連線的用戶端內容。
語法
NDIS_STATUS NdisClGetProtocolVcContextFromTapiCallId(
[in] UNICODE_STRING TapiCallId,
[out] PNDIS_HANDLE ProtocolVcContext
);
參數
[in] TapiCallId
識別特定 VC 的 Unicode 字串。 此字串是先前由 NdisCoGetTapiCallID 函式傳回的字串標識碼 Unicode 版本。
[out] ProtocolVcContext
呼叫端配置的NDIS_HANDLE指標,該NDIS_HANDLE會接收 VC 用戶端內容的句柄。 用戶端會從其 ProtocolCoCreateVc 處理程式傳回時,將此內容提供給 NDIS。
傳回值
傳回下列其中一個狀態值:
傳回碼 | 描述 |
---|---|
|
NDIS 已成功擷取由TAPI呼叫標識符字串所識別之 VC 的用戶端 VC 內容句柄。 |
|
嘗試擷取用戶端 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) |