структура NDIS_FILTER_PARTIAL_CHARACTERISTICS (ndis.h)

Статья
02/26/2024

Чтобы указать необязательные точки входа для модуля фильтра, драйвер фильтра инициализирует структуру NDIS_FILTER_PARTIAL_CHARACTERISTICS и передает ее вФункция NdisSetOptionalHandlers.

Синтаксис

typedef struct _NDIS_FILTER_PARTIAL_CHARACTERISTICS {
  NDIS_OBJECT_HEADER                            Header;
  ULONG                                         Flags;
  FILTER_SEND_NET_BUFFER_LISTS_HANDLER          SendNetBufferListsHandler;
  FILTER_SEND_NET_BUFFER_LISTS_COMPLETE_HANDLER SendNetBufferListsCompleteHandler;
  FILTER_CANCEL_SEND_HANDLER                    CancelSendNetBufferListsHandler;
  FILTER_RECEIVE_NET_BUFFER_LISTS_HANDLER       ReceiveNetBufferListsHandler;
  FILTER_RETURN_NET_BUFFER_LISTS_HANDLER        ReturnNetBufferListsHandler;
} NDIS_FILTER_PARTIAL_CHARACTERISTICS, *PNDIS_FILTER_PARTIAL_CHARACTERISTICS;

Члены

Header

Структура NDIS_OBJECT_HEADER для структуры частичных характеристик драйвера фильтра (NDIS_FILTER_PARTIAL_CHARACTERISTICS). Задайте для элемента Type структуры, указанной в заголовке , значение NDIS_OBJECT_TYPE_FILTER_PARTIAL_CHARACTERISTICS, для элемента Revision — NDIS_FILTER_PARTIAL_CHARACTERISTICS_REVISION_1, а для элемента Size — значение NDIS_SIZEOF_FILTER_PARTIAL_CHARACTERISTICS_REVISION_1.

Flags

Зарезервировано для NDIS.

SendNetBufferListsHandler

Точка входа вызывающего объектаФункция FilterSendNetBufferLists. Чтобы обойти эту функцию, присвойте этому члену значение NULL.

SendNetBufferListsCompleteHandler

Точка входа вызывающего объектаФункция FilterSendNetBufferListsComplete. Чтобы обойти эту функцию, присвойте этому члену значение NULL.

CancelSendNetBufferListsHandler

Точка входа вызывающего объектаФункция FilterCancelSendNetBufferLists. Чтобы обойти эту функцию, присвойте этому члену значение NULL.

ReceiveNetBufferListsHandler

Точка входа вызывающего объектаФункция FilterReceiveNetBufferLists. Чтобы обойти эту функцию, присвойте этому члену значение NULL.

ReturnNetBufferListsHandler

Точка входа вызывающего объектаФункция FilterReturnNetBufferLists. Чтобы обойти эту функцию, присвойте этому члену значение NULL.

Эта структура задает необязательные функции FilterXxx и другие характеристики модуля фильтра. Эти характеристики переопределяют значения по умолчанию, заданные драйвером в NDIS_FILTER_DRIVER_CHARACTERISTICS структуры, переданной драйверомФункция NdisFRegisterFilterDriver.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.0 и более поздних версиях.
Верхняя часть	ndis.h (включая Ndis.h)