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

Статья
08/07/2023

Драйвер мини-порта должен вызывать функцию NdisMSetMiniportAttributes из функции MiniportInitializeEx , чтобы определить контекстную область для адаптера мини-порта в NDIS и предоставить NDIS сведения об адаптере мини-порта.

Синтаксис

NDIS_STATUS NdisMSetMiniportAttributes(
       NDIS_HANDLE                       NdisMiniportHandle,
  [in] PNDIS_MINIPORT_ADAPTER_ATTRIBUTES MiniportAttributes
);

Параметры

NdisMiniportHandle

Адаптер мини-порта обрабатывает данные NDIS, переданные параметру MiniportAdapterHandleобъекта MiniportInitializeEx.

[in] MiniportAttributes

Указатель на NDIS_MINIPORT_ADAPTER_ATTRIBUTES объединение, содержащее структуру атрибутов, выделенных драйвером. Структура определяет атрибуты экземпляра адаптера мини-порта, который указывает MiniportAdapterHandle .

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

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

Код возврата	Описание
NDIS_STATUS_SUCCESS	NdisMSetMiniportAttributes успешно зарегистрировал атрибуты адаптера мини-порта.
NDIS_STATUS_BAD_VERSION	Указывает, что NDIS не поддерживает версию, указанную в элементе Revision структуры, указанной в элементе Header в miniportAttributes .

Драйвер мини-порта должен вызвать NdisMSetMiniportAttributes из функции MiniportInitializeEx , прежде чем драйвер вызовет любую другую функцию NdisXxx , которая зависит от информации, предоставленной NdisMSetMiniportAttributes.

The NDIS_MINIPORT_ADAPTER_ATTRIBUTES объединение является заполнителем для различных структур атрибутов. Драйвер мини-порта вызывает NdisMSetMiniportAttributes несколько раз с разными структурами атрибутов. Драйвер мини-порта должен предоставлять инициализированный NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES структуры из MiniportInitializeEx. Драйвер мини-порта должен предоставить эти атрибуты регистрации, прежде чем вызывать любую другую функцию NdisXxx , которая зависит от этих атрибутов или утверждает аппаратные ресурсы.

Драйвер предоставляет член MiniportAdapterContext для NDIS в структуре NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES . Элемент MiniportAdapterContext определяет область контекста, предоставляемую вызывающим объектом, которую NDIS передает в качестве входного параметра функциям MiniportXxxx драйвера. Эта контекстная область содержит сведения о состоянии адаптера мини-порта.

Драйверы мини-порта должны задавать атрибуты в NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES структуру после задания атрибутов регистрации в структуре NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES и до установки дополнительных атрибутов.

Драйвер мини-порта также может вызывать NdisMSetMiniportAttributes из функции MiniportAddDevice . В этом случае для указания области контекста используется структура NDIS_MINIPORT_ADD_DEVICE_REGISTRATION_ATTRIBUTES .

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.0 и более поздних версиях.
Целевая платформа	Универсальное
Верхняя часть	ndis.h (включая Ndis.h)
Библиотека	Ndis.lib
IRQL	PASSIVE_LEVEL
Правила соответствия DDI	Irql_Miniport_Driver_Function(ndis), NdisMRegisterIoPortRange(ndis)