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

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

Примечание NDIS 5. x устарел и заменен NDIS 6. x. Сведения о разработке новых драйверов NDIS см. в статье Сетевые драйверы, начиная с Windows Vista. Сведения о переносе NDIS 5. драйверов x в NDIS 6. xсм. перенос драйверов NDIS 5.x в NDIS 6.0.

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

Синтаксис

NDIS_HANDLE NdisIMGetDeviceContext(
  [in] NDIS_HANDLE MiniportAdapterHandle
);

Параметры

[in] MiniportAdapterHandle

Задает входные данные дескриптора для MiniportInitialize.

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

В следующей таблице показаны возвращаемые значения для этой функции.

Ценность Описание
NDISIMGETDEVICECONTEXT Возвращает доступ к области контекста устройства для виртуальной сетевой карты, определяемой MiniportAdapterHandle.
НЕДЕЙСТВИТЕЛЬНЫЙ Если функция ProtocolBindAdapter драйвера не выделяет такую область контекста устройства.

Замечания

Функция NDIS промежуточного драйвера MiniportInitialize вызывает вызовы NdisIMGetDeviceContext для доступа к области контекста устройства для виртуального сетевого адаптера, который он инициализирует. Как правило, память для такой области предоставляется функцией протокола ProtocolBindAdapter, которая вызывает вызов функции NdisIMInitializeDeviceInstanceEx указателем на эту область, тем самым вызыва я функцию miniportInitialize. Однако промежуточный драйвер не требуется иметь такую область контекста.

При возвращении из NdisIMGetDeviceContext, MiniportInitialize настраивает состояние, определенное драйвером для виртуальной сетевой карты, с любой информацией, указанной промежуточной записью драйвера, намерена быть полезной для более высокого уровня протоколов, которые привязывают себя впоследствии к виртуальной сетевой адаптеру.

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

версии ОС: Windows CE .NET 4.0 и более поздних версий.

Требования

Требование Ценность
заголовка ndis.h
библиотеки Ndis.lib
IRQL IRQL <= DISPATCH_LEVEL

См. также