Список функцій мініпорт як писати драйвера
Функції роботи з харчуванням станом системи і системою PlagNPlay. Сказати особливо нема чого. Стандартне відстеження внутрішніх подій системи прописане Microsoft.
MPHalt - відпрацювання вивантаження і де реєстрації драйвера при аварійному.
MPReset - як написано у Microsoft - ми не повинні нічого робити :)
Робота з системою - необхідність відпрацьовувати події важливі для сервісу коректно.
В системі може бути не один адаптер і відповідно не один драйвер до якого доводиться звертатися. У разі такого використовуються ці функції.
У нашому випадку основними функціями з цієї групи - є функції пересилання даних. Всі інші ми можемо не розглядати, їх призначення - обслуговувати правильно системні зв'язки, вся основна частина яких написана Microsoft.
Основна функція викликається завжди, при проходженні даних. За правилами роботи з даними в NDIS необхідно написати (що в прикладі і зроблено) re-wrap пакету.
Для цього спочатку пакет треба захопити, перекопіювати вміст пакета в свою пам'ять і переслати його далі, після чого звільнити пакет. Ось як буде це виглядати в коді:
PADAPT pAdapt = (PADAPT) MiniportAdapterContext;
Контекст адаптера приходить в якості параметра. Дамо його своєму типізовану вказівником.
Наш пакет - поки тільки покажчик.
PVOID MediaSpecificInfo = NULL;
Тип адаптера з яким будемо працювати.
ULONG MediaSpecificInfoSize = 0;
Розмір типу адаптера.
Перевірка наявності другого мережевого адаптера. Вгорі я говорив, що його наявність необхідно передбачати.
if (IsIMDeviceStateOn (pAdapt) == FALSE)
Перевірка наявності та стану.
NdisAllocatePacket (Status, MyPacket, pAdapt-> SendPacketPoolHandle);
Виділення місця під розмір отриманого пакета (Pool) даних.
if (Status == NDIS_STATUS_SUCCESS)
PNDIS_PACKET_EXTENSION Old, New;
Установка її в наш внутрішній буфер.
NdisMoveMemory (NDIS_OOB_DATA_FROM_PACKET (MyPacket), NDIS_OOB_DATA_FROM_PACKET (Packet), sizeof (NDIS_PACKET_OOB_DATA));
Перенесення даних в сам пакет.
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)
Якщо немає затримки на відсилання звільнити пакет.
Це говорить про відсутність пакету в системі - нічого не треба робити.
Повернення значення SUCCESS або код помилки.
Варто зупинитися ще на одному моменті. Коли система відповіла, що посилка даних закінчена кодом затримки пакета - NDIS_STATUS_PENDING.
В цьому випадку ми пакет не звільнимо, блокувавши таким чином всю систему NDIS з пересилання даних. Таке трапляється при посилці по повільній мережі великого числа пакетів.
Як нам звільнити пакет? Система передбачає таке і при звільненні ресурсу після звільнення пакета викличе функцію з групи протоколу PtSendComplete. Зміна на протокольну групу викликана тим, що система отримає повідомлення від низлежащего драйвера, що викликає звернення саме до цієї групи.
У даній функції, код якої йде слідом ми побачимо параметри в яких нам передадуть контекст операції Send і адаптера, в результаті чого ми отримаємо можливість викликати функцію NdisMSendComplete після NdisDprFreePacket і звільнити NDIS для передачі нам наступних пакетів.
PADAPT pAdapt = (PADAPT) ProtocolBindingContext;