Читать «Как писать драйвера» онлайн - страница 6

// DeviceName that names the device object.
NdisInitUnicodeString(&ntDeviceName, L"\\Device\\passthru" );
// SymbolicName that is the Win32-visible name of the device
NdisInitUnicodeString(&win32DeviceName, L"\\DosDevices\\passthru" );
//Создаем строку имени
NdisZeroMemory(MajorFunctions, sizeof(MajorFunctions));
// Регистрируем ее
//Связываем имена функций с массивом
MajorFunctions[IRP_MJ_CREATE] = FilterOpen;
MajorFunctions[IRP_MJ_CLOSE] = FilterClose;
MajorFunctions[IRP_MJ_READ] = FilterRead;
MajorFunctions[IRP_MJ_WRITE] = FilterWrite;
MajorFunctions[IRP_MJ_DEVICE_CONTROL] = FilterIoControl;
//Регистрируем их
Status = NdisMRegisterDevice(WrapperHandle, &ntDeviceName, &win32DeviceName, MajorFunctions, &deviceObject, &GlobalData.NdisDeviceHandle );
// проверяем статус
if (Status != NDIS_STATUS_SUCCESS ) {
 if (GlobalData.ProtHandle) NdisDeregisterProtocol(&Status, GlobalData.ProtHandle);
 if (GlobalData.NdisDeviceHandle) NdisMDeregisterDevice(GlobalData.NdisDeviceHandle);
 if (WrapperHandle) NdisTerminateWrapper(WrapperHandle, NULL);
 return (Status);
}
// set access method into deviceObject ( received from NdisMRegisterDevice() )
// объявление буферизации для связывающих операций
deviceObject->Flags |= DO_BUFFERED_IO;
// все.

Тела функций, типа Filter, объявите сразу после тела функции DriverEntry и оставьте пока пустыми, добавив, только возвращение значения

return NDIS_STATUS_SUCCESS;

Как писать драйвера (часть 4)

В прошлый раз мы заготовили списки необходимых функций, зарегистрировали их, а сегодня рассмотрим их поподробнее.

Группа минипорт.

Функции этой группы занимаются обработкой потока данных и событий, происходящих в верхнем уровне драйвера, и вызываемых обращением к NDIS TCP/IP стека.

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

Список функций минипорт:

MPInitialize – инициализация группы.

MPSend

MPSendPackets

MPTransferData

MPReturnPacket

Функции отвечающие за пересылку пакетов данных.

MPQueryInformation

MPSetInformation

MPQueryPNPCapbilities

MPIsSendOID

MPProcessSetPowerOid

Функции работы с питанием состоянием системы и системой PlagNPlay. Сказать особенно нечего. Стандартное отслеживание внутренних событий системы прописанное Microsoft.

MPHalt – отработка выгрузки и де регистрации драйвера при аварийном.

MPReset – как написано у Microsoft – мы не должны ничего делать :)

Работа с системой – необходимость отрабатывать события важные для сервиса корректно.

MPSetMiniportSecondary

MPPromoteSecondary

MPBundleSearchAndSetSecondary

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

В нашем случае основными функциями из этой группы – являются функции пересылки данных. Все остальные мы можем не рассматривать, их назначение – обслуживать правильно системные связи, вся основная часть которых написана Microsoft.