Функция NdisIMGetBindingContext (ndis.h)

  • Статья

Функция NdisIMGetBindingContext позволяет драйверу протокола NDIS получить доступ к области контекста устройства, созданной базовым промежуточным драйвером, для виртуального мини-порта, к которому привязан драйвер протокола более высокого уровня.

Синтаксис

NDIS_HANDLE NdisIMGetBindingContext(
  [in] NDIS_HANDLE NdisBindingHandle
);

Параметры

[in] NdisBindingHandle

Дескриптор привязки, возвращаемый функцией NdisOpenAdapterEx в параметре NdisBindingHandle , идентифицирующий виртуальный мини-порт следующего драйвера нижнего промежуточного уровня, к которому привязан вызывающий объект.

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

NdisIMGetBindingContext возвращает дескриптор в область контекста устройства для данного виртуального мини-порта или возвращает значение NULL , если такой области контекста не существует.

Комментарии

Драйвер протокола или промежуточный драйвер может вызывать NdisIMGetBindingContext из функции ProtocolBindAdapterEx для доступа к контексту устройства для виртуального мини-порта, к которому он привязан. Контекст устройства предоставляет общую область контекста для всех чрезмерно соответствующих драйверов протокола, привязанных к одному базовому промежуточному драйверу.

Такая область контекста устройства была выделена и определена промежуточным драйвером NDIS нижнего уровня и передана в NDIS в вызове Функция NdisIMInitializeDeviceInstanceEx .

Все драйверы протокола, вызывающие NdisIMGetBindingContext , могут безопасно предположить, что базовый промежуточный драйвер выделил свою область контекста из невыгружаемого пула. Они должны рассматривать возвращенную область контекста как доступную только для чтения, сохраняя состояние, настроенное базовым промежуточным драйвером NDIS, который ее определил.

Требования

Требование Значение
Минимальная версия клиента Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. раздел NdisIMGetBindingContext (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. раздел NdisIMGetBindingContext (NDIS 5.1)) в Windows XP.
Целевая платформа Персональный компьютер
Верхняя часть ndis.h (включая Ndis.h)
Библиотека Ndis.lib
IRQL < DISPATCH_LEVEL
Правила соответствия DDI Irql_IM_Function(ndis)

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

NdisIMInitializeDeviceInstanceEx

NdisOpenAdapterEx

ProtocolBindAdapterEx