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

Статья
02/07/2025

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 для идентификации каждого VC. Позже, если приложение 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 (include Ndis.h)
библиотеки	Ndis.lib
IRQL	DISPATCH_LEVEL
правил соответствия DDI	Irql_Protocol_Driver_Function(ndis)

См. также

NdisCoCreateVc

NdisCoGetTapiCallId

UNICODE_STRING

Поделиться через