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

Статья
02/07/2025

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

Синтаксис

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

Параметры

NdisMiniportHandle

Обработчик минипорта, передаваемый NDIS в параметр MiniportAdapterHandleMiniportInitializeEx.

[in] MiniportAttributes

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

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

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

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

Замечания

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

Тем 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 (include Ndis.h)
библиотеки	Ndis.lib
IRQL	PASSIVE_LEVEL
правил соответствия DDI	Irql_Miniport_Driver_Function(ndis), NdisMRegisterIoPortRange(ndis)