Функция 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 (include Ndis.h) |
| библиотеки | Ndis.lib |
| IRQL | < DISPATCH_LEVEL |
| правил соответствия DDI | Irql_IM_Function(ndis) |