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

Статья
02/07/2025

Функция OpenNDKAdapterHandler (OPEN_NDK_ADAPTER_HANDLER) открывает экземпляр адаптера NDK на мини-адаптере с поддержкой NDK.

Синтаксис

OPEN_NDK_ADAPTER_HANDLER OpenNdkAdapterHandler;

NDIS_STATUS OpenNdkAdapterHandler(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] PNDIS_OPEN_NDK_ADAPTER_PARAMETERS Parameters,
       NDK_ADAPTER **ppNdkAdapter
)
{...}

Параметры

[in] MiniportAdapterContext

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

[in] Parameters

Указатель на структуру NDIS_OPEN_NDK_ADAPTER_PARAMETERS, которая определяет входные параметры для открытия экземпляра NDK_ADAPTER.

Структура NDIS_OPEN_NDK_ADAPTER_PARAMETERS должна указывать основную версию NDKPI и минимальную версию NDKPI, которую может поддерживать потребитель NDK.

Если поставщик не поддерживает указанную потребителем основную версию, поставщик должен завершить запрос NDIS_STATUS_BAD_VERSION.

Если поставщик поддерживает основную версию, указанную потребителем, и указанная дополнительная версия меньше или равна самой высокой дополнительной версии, которую поддерживает поставщик, поставщик должен выполнить запрос и использовать самую высокую дополнительную версию, которую поддерживает поставщик.

Например, если потребитель запрашивает версию 1.0 и поставщик поддерживает 1.1, поставщик должен сообщить о версии 1.1 в заголовках NDK_ADAPTER_INFO структуры и объектов NDK.

Примечание более поздних версий в поставщике всегда полностью совместимы с (т. е. супермножеством) более низких дополнительных версий.

Если поставщик поддерживает основную версию, указанную потребителем, и указанная дополнительная версия больше, чем самая высокая дополнительная версия, которую поддерживает поставщик, поставщик должен завершить запрос NDIS_STATUS_BAD_VERSION.

ppNdkAdapter

Указатель на переменную, содержащую указатель на структуру NDK_ADAPTER. При возврате из OPEN_NDK_ADAPTER_HANDLERструктура NDK_ADAPTER, на которую ссылается ppNdkAdapter, идентифицирует только что открытый экземпляр адаптера NDK.

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

OPEN_NDK_ADAPTER_HANDLER может возвращать одно из следующих значений:

Возвращаемый код	Описание
NDIS_STATUS_SUCCESS	Экземпляр адаптера NDK был успешно открыт.
NDIS_STATUS_BAD_VERSION	Запрошенный номер версии не поддерживается.
NDIS_STATUS_ADAPTER_NOT_READY	Функция NDK мини-адаптера не включена.
NDIS_STATUS_RESOURCES	NDIS не удалось открыть адаптер NDK из-за нехватки ресурсов.

Замечания

OPEN_NDK_ADAPTER_HANDLER открывает экземпляр NDK_ADAPTER на мини-адаптере NDK с поддержкой NDK. Несколько NDK_ADAPTER экземпляров можно создать на одном и том же минипорте NDIS. Каждый экземпляр NDK_ADAPTER содержит указатель на таблицу функций диспетчеризации, реализующих интерфейс программирования приложений NDK. Драйвер минипорта вызывает функцию CLOSE_NDK_ADAPTER_HANDLER, чтобы закрыть экземпляр адаптера NDK и освободить связанные ресурсы.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Не поддерживается, поддерживается в NDIS 6.30 и более поздних версиях.
минимальный поддерживаемый сервер	Windows Server 2012
целевая платформа	Виндоус
заголовка	ndisndk.h
IRQL	PASSIVE_LEVEL