Функции этой группы занимаются обработкой потока данных и событий, происходящих в верхнем уровне драйвера, и вызываемых обращением к NDIS TCP/IP стека.
Если посмотреть на схемы из второй части, то видно, что в нижней части находятся функции протокола, а в верхней минипорта. Почему? Каждый драйвер выступает в двух ипостасях. Общаясь с верхним уровнем драйверов он становиться для него драйвером минипорта, а для нижнего уровня, драйвером протокола.
Список функций минипорт:
MPInitialize – инициализация группы.
MPSend
MPSendPackets
MPTransferData
MPReturnPacket
Функции отвечающие за пересылку пакетов данных.
MPQueryInformation
MPSetInformation
MPQueryPNPCapbilities
MPIsSendOID
MPProcessSetPowerOid
Функции работы с питанием состоянием системы и системой PlagNPlay. Сказать особенно нечего. Стандартное отслеживание внутренних событий системы прописанное Microsoft.
MPHalt – отработка выгрузки и де регистрации драйвера при аварийном.
MPReset – как написано у Microsoft – мы не должны ничего делать :)
Работа с системой – необходимость отрабатывать события важные для сервиса корректно.
MPSetMiniportSecondary
MPPromoteSecondary
MPBundleSearchAndSetSecondary
В системе может быть не один адаптер и соответственно не один драйвер к которому приходится обращаться. В случае такого используются эти функции.
В нашем случае основными функциями из этой группы – являются функции пересылки данных. Все остальные мы можем не рассматривать, их назначение – обслуживать правильно системные связи, вся основная часть которых написана Microsoft.
MPSend
Основная функция вызываемая всегда, при прохождении данных. По правилам работы с данными в NDIS необходимо написать (что в примере и сделано) re-wrap пакету.
Для этого сначала пакет надо захватить, перекопировать содержимое пакета в свою память и переслать его далее, после чего освободить пакет. Вот как будет это выглядеть в коде:
>PADAPT pAdapt = (PADAPT)MiniportAdapterContext;
Контекст адаптера приходящий в качестве параметра. Присвоим его своему типизированному указателю.
>NDIS_STATUS Status;
Возвращаемый статус.
>PNDIS_PACKET MyPacket;
Наш пакет – пока только указатель.
>PRSVD Rsvd;
Резервный указатель.
>PVOID MediaSpecificInfo = NULL;
Тип адаптера с которым будем работать.
>ULONG MediaSpecificInfoSize = 0;
Размер типа адаптера.
>ASSERT (pAdapt->pSecondaryAdapt);
>pAdapt = pAdapt->pSecondaryAdapt;
Проверка наличия второго сетевого адаптера. Вверху я говорил, что его наличие необходимо предусматривать.
>if (IsIMDeviceStateOn (pAdapt) == FALSE) {
> return NDIS_STATUS_FAILURE;
>}
Проверка наличия и состояния.
>NdisAllocatePacket(&Status, &MyPacket, pAdapt->SendPacketPoolHandle);
Выделение места под размер полученного пакета (Pool) данных.
>if (Status == NDIS_STATUS_SUCCESS) {
> PNDIS_PACKET_EXTENSION Old, New;
> Rsvd = (PRSVD)(MyPacket->ProtocolReserved);
> Rsvd->OriginalPkt = Packet;
> MyPacket->Private.Flags = Flags;
> MyPacket->Private.Head = Packet->Private.Head;
> MyPacket->Private.Tail = Packet->Private.Tail;
Собственно копирование всей служебной информации
>NdisSetPacketFlags(MyPacket, NDIS_FLAGS_DONT_LOOPBACK);
Установка ее в наш внутренний буфер.
>NdisMoveMemory(NDIS_OOB_DATA_FROM_PACKET(MyPacket), NDIS_OOB_DATA_FROM_PACKET(Packet), sizeof(NDIS_PACKET_OOB_DATA));
Перенос данных в сам пакет.
>NdisIMCopySendPerPacketInfo(MyPacket, Packet);
Копирование служебных данных по пересылке пакета.
Копирование данных о типе адаптера, куда пересылать данные.
>NDIS_GET_PACKET_MEDIA_SPECIFIC_INFO(Packet, &MediaSpecificInfo, &MediaSpecificInfoSize);
>if (MediaSpecificInfo || MediaSpecificInfoSize) {
> NDIS_SET_PACKET_MEDIA_SPECIFIC_INFO(MyPacket, MediaSpecificInfo, MediaSpecificInfoSize);
>}
Собственно пересылка имеющихся данных в NDIS, что вызовет нормальное прохождение пакета далее по цепочке драйверов.
>NdisSend(&Status, pAdapt->BindingHandle, MyPacket);
>if (Status != NDIS_STATUS_PENDING) {
> NdisIMCopySendCompletePerPacketInfo (Packet, MyPacket);
