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

Статья
02/07/2025

Драйвер фильтра вызывает функцию NdisFSetAttributes, чтобы указать область контекста модуля фильтра.

Синтаксис

NDIS_STATUS NdisFSetAttributes(
  [in] NDIS_HANDLE                  NdisFilterHandle,
  [in] __drv_aliasesMem NDIS_HANDLE FilterModuleContext,
  [in] PNDIS_FILTER_ATTRIBUTES      FilterAttributes
);

Параметры

[in] NdisFilterHandle

Дескриптор NDIS, определяющий этот модуль фильтра. NDIS передал дескриптор драйверу фильтра в вызове функции FilterAttach.

[in] FilterModuleContext

Область контекста, выделенная вызывающим объектом для этого модуля фильтра.

[in] FilterAttributes

Указатель на выделенный драйвер фильтра структура NDIS_FILTER_ATTRIBUTES.

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

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

Возвращаемый код	Описание
NDIS_STATUS_SUCCESS	NdisFSetAttributes возвращает NDIS_STATUS_SUCCESS, если он задает атрибуты драйвера фильтра.
NDIS_STATUS_RESOURCES	NdisFSetAttributes произошел сбой из-за нехватки ресурсов.
NDIS_STATUS_FAILURE	NdisFSetAttributes возвращает NDIS_STATUS_FAILURE, если ни одно из предыдущих значений не применяется.

Замечания

Драйвер фильтра вызывает NdisFSetAttributes из функции filterAttach и передает дескриптор, передаваемый NDIS FilterAttach в параметре NdisFilterHandle. Параметр FilterModuleContextNdisFSetAttributes задает область контекста для этого модуля фильтра. NDIS передает область контекста обратно драйверу фильтра в вызовах функций, таких как FilterSendNetBufferLists.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.0 и более поздних версиях.
целевая платформа	Настольный
заголовка	ndis.h (include Ndis.h)
библиотеки	Ndis.lib
IRQL	PASSIVE_LEVEL
правил соответствия DDI	Irql_Filter_Driver_Function(ndis)

См. также

FilterAttach

FilterSendNetBufferLists

NDIS_FILTER_ATTRIBUTES

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