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

Драйвер минипорта должен вызвать функцию 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 не поддерживает версию, указанную в члене редакции структуры, указанной в элементе заголовка в 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 (включая Ndis.h)
Библиотека Ndis.lib
IRQL PASSIVE_LEVEL
Правила соответствия DDI Irql_Miniport_Driver_Function(ndis), NdisMRegisterIoPortRange(ndis)

См. также раздел

Инициализация минипорт-адаптера

MiniportInitializeEx

NDIS_MINIPORT_ADAPTER_ATTRIBUTES NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_NDK_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_OFFLOAD_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES

NDIS_MINIPORT_ADD_DEVICE_REGISTRATION_ATTRIBUTES

Настройка атрибутов адаптера минипорта NDIS 6.0