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

  • Статья

Функция MiniportCoDeleteVc необходима для мини-портов, ориентированных на подключение. MiniportCoDeleteVc указывает, что VC удаляется и удаляется NDIS.

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

Синтаксис

MINIPORT_CO_DELETE_VC MiniportCoDeleteVc;

NDIS_STATUS MiniportCoDeleteVc(
  [in] NDIS_HANDLE MiniportVcContext
)
{...}

Параметры

[in] MiniportVcContext

Указывает дескриптор для области контекста, выделенной драйвером мини-порта, в которой драйвер мини-порта сохраняет свое состояние для каждого VC. Драйвер мини-порта предоставил этот дескриптор NDIS из функции MiniportCoCreateVc .

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

Код возврата Описание
NDIS_STATUS_SUCCESS
 Указывает, что драйвер мини-порта успешно освободил все ресурсы, выделенные для этого VC.

Комментарии

MiniportCoDeleteVcmust записывается как синхронная функция и ни при каких обстоятельствах не может возвращать NDIS_STATUS_PENDING, не вызывая системный сбой.

MiniportCoDeleteVc освобождает все ресурсы, выделенные для каждого виртуального удостоверения и хранящиеся в области контекста MiniportVcContext . Драйвер мини-порта также должен освободить miniportVcContext , выделенный в его функции MiniportCoCreateVc .

Примеры

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

Например, чтобы определить функцию MiniportCoDeleteVc с именем MyCoDeleteVc, используйте тип MINIPORT_CO_DELETE_VC , как показано в следующем примере кода:

MINIPORT_CO_DELETE_VC MyCoDeleteVc;

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

_Use_decl_annotations_
NDIS_STATUS
 MyCoDeleteVc(
    NDIS_HANDLE  MiniportVcContext
    )
  {...}

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

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

Требования

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

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

MiniportCoCreateVc