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

  • Статья

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

NdisGetReceivedPacket извлекает пакет, полученный от базового драйвера.

Синтаксис

PNDIS_PACKET NdisGetReceivedPacket(
  [in] NDIS_HANDLE NdisBindingHandle,
  [in] NDIS_HANDLE MacContext
);

Параметры

[in] NdisBindingHandle

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

[in] MacContext

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

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

Возвращает указатель на дескриптор пакета, содержащий данные, полученные в базовом драйвере.

Комментарии

К одному базовому сетевому адаптеру можно привязать несколько протоколов или промежуточных драйверов, и каждый такой драйвер может получить указание на один и тот же пакет. Такой пакет доступен только для чтения для этих драйверов. Функция ProtocolReceive каждого такого драйвера определяет, следует ли вызывать NdisGetReceivedPacket для получения указанного пакета.

  • Целевая платформа: универсальная
  • Версия: не поддерживается для драйверов NDIS 6.0 в Windows Vista. Поддерживается для драйверов NDIS 5.1 в Windows Vista и Windows XP.

Требования

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

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