Функция 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 возвращает одно из следующих значений состояния:
Код возврата | Описание |
---|---|
|
NdisMSetMiniportAttributes успешно зарегистрировал атрибуты адаптера мини-порта. |
|
Указывает, что 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) |
См. также раздел
Инициализация адаптера miniport
NDIS_MINIPORT_ADAPTER_ATTRIBUTES NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTESNDIS_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Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по