Функция NdisMRegisterWdiMiniportDriver (dot11wdi.h)

Важный

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

Драйвер минипорта вызывает функцию NdisMRegisterWdiMiniportDriver, чтобы зарегистрировать точки входа MiniportWdiXxx с помощью NDIS в качестве первого шага при инициализации.

Синтаксис

NDIS_EXPORTED_ROUTINE NDIS_STATUS NdisMRegisterWdiMiniportDriver(
  [in]           DRIVER_OBJECT                            *DriverObject,
  [in]           PCUNICODE_STRING                         RegistryPath,
  [in, optional] NDIS_MINIPORT_DRIVER_CONTEXT             NdisDriverContext,
  [in]           NDIS_MINIPORT_DRIVER_CHARACTERISTICS     *MiniportDriverCharacteristics,
  [in]           NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS *MiniportWdiCharacteristics,
  [out]          NDIS_MINIPORT_DRIVER_HANDLE              *NdisMiniportDriverHandle
);

Параметры

[in] DriverObject

Указатель на непрозрачный объект драйвера, который драйвер минипорта получил в подпрограмме DriverEntry DriverEntry в параметре Argument1 (см. раздел DriverEntry NDIS Miniport Driver).

[in] RegistryPath

Указатель на непрозрачный путь реестра, который драйвер минипорта получил в подпрограмме driverEntry DriverEntry в параметре Argument2.

[in, optional] NdisDriverContext

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

[in] MiniportDriverCharacteristics

Указатель на объект NDIS_MINIPORT_DRIVER_CHARACTERISTICS структуру, которую инициализировал вызывающий объект.

[in] MiniportWdiCharacteristics

Указатель на структуру NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS, которую инициализировал вызывающий объект.

[out] NdisMiniportDriverHandle

Указатель на переменную, предоставляемую вызывающим дескриптором. NDIS записывает дескриптор в эту переменную, которая однозначно идентифицирует этот драйвер. Драйвер должен сохранить этот дескриптор для использования в последующих вызовах функций NdisXxx.

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

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

Возвращаемый код Описание
NDIS_STATUS_SUCCESS
 NdisMRegisterWdiMiniportDriver успешно зарегистрировал драйвер минипорта WDI.
NDIS_STATUS_BAD_CHARACTERISTICS
 Параметр CharacteristicsLength неверный для версии NDIS, указанной в элементе MajorNdisVersion в структуре MiniportDriverCharacteristics.
NDIS_STATUS_BAD_VERSION
 Недопустимый MajorNdisVersion или MinorNdisVersion, указанный в структуре характеристик.
NDIS_STATUS_RESOURCES
 Нехватка ресурсов, возможно, памяти, не позволила NDIS зарегистрировать вызывающий объект.
NDIS_STATUS_FAILURE
 Это состояние ошибки по умолчанию, возвращаемое, когда ни одна из предыдущих ошибок не привела к сбою регистрации.
другие коды NDIS_STATUS
 Соответствующий NDIS_STATUS код в случае сбоя.

Требования

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

См. также

DRIVER_OBJECT

NDIS_MINIPORT_DRIVER_CHARACTERISTICS

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

  • Last updated on