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

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

  • Статья

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

Синтаксис

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

Параметры

[in] NdisVcHandle

Указывает дескриптор NDIS для VC. Этот дескриптор был предоставлен NDIS при первоначальном создании VC с помощью функции NdisCoCreateVc .

[in, out] TapiCallId

Указатель на буфер, выделенный вызывающим объектом, который получает структуру данных типа VAR_STRING. После успешного возврата эта структура описывает строку, которую приложения TAPI могут использовать для идентификации проверяемого экземпляра.

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

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

Код возврата Описание
NDIS_STATUS_SUCCESS
 NDIS успешно вернул строковый идентификатор для VC.
NDIS_STATUS_BUFFER_TOO_SHORT
 Член ulTotalSize структуры VAR_STRING указывает, что размер буфера не достаточно велик для хранения строки, идентифицируемой виртуальной машины. NdisCoGetTapiCallId задает член ulNeededSize структуры VAR_STRING требуемый размер в байтах.
NDIS_STATUS_INVALID_DATA
 Дескриптор для VC, заданного NdisVcHandle , недопустим.

Комментарии

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

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

Дополнительные сведения о структуре VAR_STRING см. в разделе Объекты TAPI.

Требования

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

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

NdisClGetProtocolVcContextFromTapiCallId

NdisCoCreateVc