OID_NDK_SET_STATE

Статья
13.03.2025

В качестве запроса набора NDIS и более скользящие драйверы используют OID_NDK_SET_STATE OID, чтобы задать состояние функциональных возможностей NDK мини-адаптера.

NDIS 6.30 и более поздних мини-портов, которые предоставляют службы NDK, должны поддерживать этот OID. В противном случае этот OID является необязательным.

Замечания

NDIS выдает этот OID с элементом InformationBuffer InformationBuffer NDIS_OID_REQUEST, указывающим на BOOLEAN и InformationBufferLength член равно sizeof(BOOLEAN).

Если значение BOOLEAN равно TRUE, а значение ключевого слова networkDirect *NetworkDirect ненулевое, необходимо включить функциональные возможности NDK адаптера мини-порта.

Минипорт-драйвер может прочитать значение ключевого слова *NetworkDirect, выполнив следующие действия:
1. Вызов NdisOpenConfigurationEx с дескриптором NDIS, который функция NdisMRegisterMiniportDrive r возвращается при инициализации драйвера мини-порта. Дополнительные сведения о вызове NdisOpenConfigurationExсм. в чтении реестра вдрайвера минипорта NDIS 6.0.
2. Вызов NdisReadConfiguration, передавая:
  - "*NetworkDirect" для параметра ключевого слова
  - NdisParameterInteger для параметра ParameterType
Если значение BOOLEAN равно FALSE, необходимо отключить функциональные возможности NDK мини-адаптера.

Чтобы включить или отключить функцию обратного вызова NDK, функции обратного вызова минипорт-драйвера miniportOidReque st следует выполнить действия, описанные в включении и отключении функций NDK.

Примечание драйвер мини-порта с поддержкой NDK никогда не должен вызывать NdisMNetPnPEvent из контекста его функции MiniportOidRequest, так как это может привести к взаимоблокировке. Вместо этого он должен вызывать NdisMNetPnPEvent из другого контекста или очереди рабочего элемента.

Функция минипорта с поддержкой NDK MiniportOidRequest должна возвращать STATUS_SUCCESS для запроса OID_NDK_SET_STATE OID, если не произойдет сбой. Драйвер не должен возвращать NDIS_STATUS_PENDING.

Требования

Минимальный поддерживаемый клиент	Не поддерживается
Минимальный поддерживаемый сервер	Windows Server 2012
Версия	Поддерживается в NDIS 6.30 и более поздних версиях.
Заголовок	Ntddndis.h (include Ndis.h)