Функция NdisClGetProtocolVcContextFromTapiCallId (ndis.h)

Статья
08/07/2023

NdisClGetProtocolVcContextFromTapiCallId извлекает контекст клиента для виртуального подключения (VC), определяемого строкой идентификатора вызова TAPI.

Синтаксис

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

Параметры

[in] TapiCallId

Строка Юникода, идентифицирующая конкретный VC. Эта строка представляет собой версию идентификатора строки в Юникоде, который ранее был возвращен функцией NdisCoGetTapiCallID .

[out] ProtocolVcContext

Указатель на выделенный вызывающим NDIS_HANDLE, который получает дескриптор контекста клиента для VC. Клиент предоставил этот контекст NDIS при возврате из обработчика ProtocolCoCreateVc .

Возвращаемое значение

Возвращает одно из следующих значений состояния:

Код возврата	Описание
NDIS_STATUS_SUCCESS	NDIS успешно извлек дескриптор в контексте клиентского VC для VC, определяемого строкой идентификатора вызова TAPI.
NDIS_STATUS_FAILURE	Не удалось получить дескриптор в контекст клиентского VC.

Предположим, что диспетчер вызовов вызывает NdisCoCreateVc , чтобы создать VC для вызова TAPI. NDIS, в свою очередь, предоставляет дескриптор для VC клиенту. Клиент передает этот дескриптор VC в вызове функции NdisCoGetTapiCallId , чтобы получить строковый идентификатор для VC. Затем клиент может представить этот идентификатор в виде строки Юникода в NdisClGetProtocolVcContextFromTapiCallId , чтобы вернуть контекст для VC.

Клиент создает контекст для каждого управляемого VC. Клиент использует NdisCoGetTapiCallId для получения идентификатора строки для каждого VC. Клиент передает каждый строковый идентификатор в приложение TAPI для идентификации каждого проверяемого экземпляра. Позже, если приложение TAPI передает один из этих строковых идентификаторов клиенту в операции, связанной с VC, клиент должен передать этот строковый идентификатор в виде строки Юникода в вызове NdisClGetProtocolVcContextFromTapiCallId , чтобы вернуть правильный контекст для VC.

Дополнительные сведения см. в разделе структура UNICODE_STRING .

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. раздел NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. раздел NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1)) в Windows XP.
Целевая платформа	Персональный компьютер
Верхняя часть	ndis.h (включая Ndis.h)
Библиотека	Ndis.lib
IRQL	DISPATCH_LEVEL
Правила соответствия DDI	Irql_Protocol_Driver_Function(ndis)

См. также раздел

NdisCoCreateVc

NdisCoGetTapiCallId

UNICODE_STRING