функция обратного вызова MINIPORT_WDI_ALLOCATE_ADAPTER (dot11wdi.h)

Статья
02/06/2025

Важный

Этот раздел является частью модели драйвера WDI , выпущенной в Windows 10. Модель драйвера WDI находится в режиме обслуживания и получит только исправления с высоким приоритетом. WiFiCx — это модель драйвера Wi-Fi, выпущенная в Windows 11. Мы рекомендуем использовать WiFiCx для использования новейших функций.

Функция обработчика MiniportWdiAllocateAdapter выделяет мини-порт WDI.

Это обработчик минипорта WDI внутри NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.

Примечание Необходимо объявить функцию с помощью типа MINIPORT_WDI_ALLOCATE_ADAPTER. Дополнительные сведения см. в следующем разделе "Примеры".

Синтаксис

MINIPORT_WDI_ALLOCATE_ADAPTER MiniportWdiAllocateAdapter;

NDIS_STATUS MiniportWdiAllocateAdapter(
  [in]      NDIS_HANDLE NdisMiniportHandle,
  [in]      NDIS_HANDLE MiniportDriverContext,
  [in]      PNDIS_MINIPORT_INIT_PARAMETERS MiniportInitParameters,
  [in]      PNDIS_WDI_INIT_PARAMETERS NdisWdiInitParameters,
  [in, out] PNDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES RegistrationAttributes
)
{...}

Параметры

[in] NdisMiniportHandle

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

[in] MiniportDriverContext

Дескриптор области контекста, выделенной драйвером, где драйвер хранит сведения о состоянии и конфигурации. Минипорт-драйвер передал эту область контекста функции NdisMRegisterWdiMiniportDriver.

[in] MiniportInitParameters

Указатель на структуру NDIS_MINIPORT_INIT_PARAMETERS, которая определяет параметры инициализации для мини-адаптера.

[in] NdisWdiInitParameters

Указатель на структуру NDIS_WDI_INIT_PARAMETERS, которая определяет параметры инициализации WDI для мини-адаптера.

[in, out] RegistrationAttributes

Указатель на структуру NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES, которая определяет атрибуты регистрации, связанные с мини-адаптером.

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

MiniportWdiAllocateAdapter может возвращать любое из следующих возвращаемых значений.

Возвращаемый код	Описание
NDIS_STATUS_SUCCESS	MiniportWdiAllocateAdapter успешно завершен.
NDIS_STATUS_RESOURCES	MiniportWdiAllocateAdapter не удалось выделить необходимые ресурсы.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10
минимальный поддерживаемый сервер	Windows Server 2016
целевая платформа	Виндоус
заголовка	dot11wdi.h

См. также

NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

NDIS_MINIPORT_INIT_PARAMETERS

NDIS_WDI_INIT_PARAMETERS

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