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

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

  • Статья

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

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

Синтаксис

NDIS_HANDLE NdisIMGetDeviceContext(
  [in] NDIS_HANDLE MiniportAdapterHandle
);

Параметры

[in] MiniportAdapterHandle

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

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

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

Значение Описание
NDISIMGETDEVICECONTEXT Возвращает доступ к области контекста устройства для виртуальной сетевой карты, определенной MiniportAdapterHandle.
NULL Если функция ProtocolBindAdapter драйвера не выделила такую область контекста устройства.

Комментарии

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

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

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

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

Требования

Требование Значение
Заголовок ndis.h
Библиотека Ndis.lib
IRQL IRQL <= DISPATCH_LEVEL

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