Поделиться через

OID_NDK_SET_STATE

  • Статья

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

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

Комментарии

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

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

    Драйвер мини-порта может считывать значение *NetworkDirect ключевое слово, выполнив следующие действия:

    1. Вызовите NdisOpenConfigurationEx с дескриптором NDIS, возвращенным функцией NdisMRegisterMiniportDriver при инициализации драйвера мини-порта. Дополнительные сведения о вызове NdisOpenConfigurationEx см. в статье Чтение реестра в драйвере NDIS 6.0 Miniport.

    2. Вызовите NdisReadConfiguration, передав:

      • "*NetworkDirect" для параметра keyword

      • NdisParameterInteger для параметра ParameterType

  • Если значение BOOLEAN равно FALSE, необходимо отключить функциональность NDK адаптера мини-порта.

Чтобы включить или отключить функции NDK, функция обратного вызова MiniportOidRequest драйвера miniport Следует выполнить действия, описанные в разделе Включение и отключение функций NDK.

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

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

Требования

Минимальная версия клиента

Ни одна версия не поддерживается

Минимальная версия сервера

Windows Server 2012

Версия

Поддерживается в NDIS 6.30 и более поздних версиях.

Заголовок

 Ntddndis.h (включая Ndis.h)

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

NDIS_OID_REQUEST

NdisMNetPnPEvent

NdisQueueIoWorkItem

NdisReadConfiguration

NDK_ADAPTER

OID_NDK_SET_STATE