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

  • Статья

Платформа PacketDirect (PD) вызывает функцию NdisPDClearReceiveFilter драйвера мини-порта с поддержкой PD, чтобы очистить этот фильтр от платформы PD.

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

 

Синтаксис

NDIS_PD_CLEAR_RECEIVE_FILTER NdisPdClearReceiveFilter;

VOID() NdisPdClearReceiveFilter(
  [in] NDIS_PD_FILTER_HANDLE FilterHandle
)
{...}

Параметры

[in] FilterHandle

Дескриптор для фильтра платформы PD.

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

Эта функция обратного вызова не возвращает значение.

Комментарии

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

Примеры

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

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

NDIS_PD_CLEAR_RECEIVE_FILTER MyPDClearReceiveFilter;

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

_Use_decl_annotations_
VOID
 MyPDClearReceiveFilter(
    NDIS_PD_FILTER_HANDLE  FilterHandle
    )
  {...}

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

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

Требования

Требование Значение
Минимальная версия клиента Windows 10
Минимальная версия сервера Windows Server 2016
Целевая платформа Windows
Header ndis.h
IRQL PASSIVE_LEVEL