Функция 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 в параметре Argument1 (см. раздел DriverEntry of NDIS Miniport Drivers).

[in] RegistryPath

Указатель на непрозрачный путь реестра, который драйвер мини-порта получил в своей подпрограмме 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
Целевая платформа Windows
Header dot11wdi.h
Библиотека Ndis.lib
IRQL PASSIVE_LEVEL

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

DRIVER_OBJECT

NDIS_MINIPORT_DRIVER_CHARACTERISTICS

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS