функция обратного вызова PROTOCOL_CL_CALL_CONNECTED (ndis.h)

Статья
02/26/2024

Функция ProtocolClCallConnected используется клиентами NDIS, ориентированными на подключение, которые принимают входящие вызовы. Такие клиенты должны иметь функции ProtocolClCallConnected . В противном случае зарегистрированная функция ProtocolClCallConnected такого драйвера протокола может просто вернуть управление.

Примечание Функцию необходимо объявить с помощью типа PROTOCOL_CL_CALL_CONNECTED . Дополнительные сведения см. в следующем разделе Примеры.

Синтаксис

PROTOCOL_CL_CALL_CONNECTED ProtocolClCallConnected;

void ProtocolClCallConnected(
  [in] NDIS_HANDLE ProtocolVcContext
)
{...}

Параметры

[in] ProtocolVcContext

Указывает дескриптор клиента для области контекста для каждого VC. Клиент первоначально вернул этот дескриптор в NDIS из функции ProtocolCoCreateVc .

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

None

Remarks

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

Вызов ProtocolClCallConnected указывает, что передача данных( как входящих, так и исходящих) теперь может осуществляться в VC. ProtocolClCallConnected должен убедиться , что клиент готов к выполнению или принятию передачи в VC, прежде чем он вернет управление.

Примеры

Чтобы определить функцию ProtocolClCallConnected , необходимо сначала предоставить объявление функции, определяющее тип определяемой функции. Windows предоставляет набор типов функций для драйверов. Объявление функции с помощью типов функций помогает анализу кода для драйверов, средству проверки статических драйверов (SDV) и другим средствам проверки находить ошибки, и это требование для написания драйверов для операционной системы Windows.

Например, чтобы определить функцию ProtocolClCallConnected с именем MyClCallConnected, используйте тип PROTOCOL_CL_CALL_CONNECTED , как показано в этом примере кода:

PROTOCOL_CL_CALL_CONNECTED MyClCallConnected;

Затем реализуйте функцию следующим образом:

_Use_decl_annotations_
VOID
 MyClCallConnected(
    NDIS_HANDLE  ProtocolVcContext
    )
  {...}

Тип функции PROTOCOL_CL_CALL_CONNECTED определен в файле заголовка Ndis.h. Чтобы более точно определить ошибки при запуске средств анализа кода, обязательно добавьте заметку Use_decl_annotations в определение функции. Заметка Use_decl_annotations гарантирует использование заметок, применяемых к типу функции PROTOCOL_CL_CALL_CONNECTED в файле заголовка. Дополнительные сведения о требованиях к объявлениям функций см. в разделе Объявление функций с помощью типов ролей функций для драйверов NDIS.

Сведения о Use_decl_annotations см. в статье О поведении функции.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. ProtocolClCallConnected (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. ProtocolClCallConnected (NDIS 5.1)) в Windows XP.
Целевая платформа	Windows
Header	ndis.h (включая Ndis.h)
IRQL	<= DISPATCH_LEVEL