Функция 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 может возвращать любое из следующих возвращаемых значений.
Код возврата | Описание |
---|---|
|
NdisMRegisterWdiMiniportDriver успешно зарегистрировал драйвер мини-порта WDI. |
|
Параметр CharacteristicsLength неверен для версии NDIS, указанной в элементе MajorNdisVersion в структуре MiniportDriverCharacteristics . |
|
Параметр MajorNdisVersion или MinorNdisVersion , указанный в структуре характеристик, недопустим. |
|
Нехватка ресурсов, возможно, памяти, не позволила NDIS зарегистрировать вызывающий объект. |
|
Это состояние ошибки по умолчанию, возвращаемое, если ни одна из предыдущих ошибок не привела к сбою регистрации. |
|
Соответствующий код NDIS_STATUS в случае сбоя. |
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 10 |
Минимальная версия сервера | Windows Server 2016 |
Целевая платформа | Windows |
Header | dot11wdi.h |
Библиотека | Ndis.lib |
IRQL | PASSIVE_LEVEL |