Использование NuMega DriverStudio для написания WDM-драйверов
вернуться

Тарво Александр
Шрифт:

status = I.PnpComplete(this, STATUS_SUCCESS, IO_NO_INCREMENT);

 }

 return status;

}

NTSTATUS MyPrettyDevice::Close(KIrp I) {

 NTSTATUS status;

 //Пользователь закончил работу с устройством, теперь оно свободно.

 //Сбрасываем флаг.

 m_AlreadyUsed = false;

 status = I.PnpComplete(this, STATUS_SUCCESS, IO_NO_INCREMENT);

 return status;

}

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

//This code was added by the programmer

Фактически в данном методе мы должны прочитать содержимое памяти и передать его приложению пользователя. Но тут самое время вспомнить, что плата обменивается с памятью 4– байтными словами. Поэтому для операций с памятью следует применять метод ind/outd.

void XDSPdrvDevice::SerialRead(KIrp I) {

 t << "Entering XDSPdrvDevice::SerialRead, " << I << EOL;

 NTSTATUS status = STATUS_SUCCESS;

 //Здесь мы получаем буфер пользователя. Он передается через Irp.

 KMemory Mem(I.Mdl);

 PUCHAR pBuffer = (PUCHAR) Mem.MapToSystemSpace;

 //Теперь pBuffer – указатель на буфер пользователя.

 //Здесь мы получаем число 4-байтных слов, которое должно быть прочитано. Оно также

 //передается через Irp, как запрашиваемое количество байт для чтения.

 ULONG dwTotalSize = I.ReadSize(CURRENT);

 ULONG dwBytesRead = dwTotalSize;

 //Здесь мы читаем заданное число байт из памяти устройства. Плата XDSP680 обменивается

 //с памятью 4-байтными словами.Начальный адрес – 0, dwTotalSize 4-байтных слов будут

 //прочитаны в буфер pBuffer.

 m_MainMem.ind(0,(ULONG*)pBuffer,dwTotalSize);

 //Возвращаем количество прочитанных слов

 I.Information = dwBytesRead;

 I.Status = status;

 //Обработать следующий IRP-пакет.

 PnpNextIrp(I);

}

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

void XDSPdrvDevice::SerialWrite(KIrp I) {

 t << "Entering XDSPdrvDevice::SerialWrite, " << I << EOL;

 NTSTATUS status = STATUS_SUCCESS;

 KMemory Mem(I.Mdl);

 PUCHAR pBuffer = (PUCHAR) Mem.MapToSystemSpace;

 ULONG dwTotalSize = I.WriteSize(CURRENT);

 ULONG dwBytesSent = dwTotalSize;

 m_MainMem.outd(0,(ULONG*)pBuffer,dwTotalSize);

 I.Information = dwBytesSent;

 I.Status = status;

 PnpNextIrp(I);

}

Как мы упоминали ранее, для большинства драйверов устройств недостаточно функций чтения и записи. Мало-мальски сложное устройство требует еще и множества других операций: получить состояние, получить информацию об устройстве, как-то отконфигурировать его. Для выполнения этих задач служат функции управления вводом-выводом, IO Control; сокращенно — IOCTL. IOCTL предоставляет программисту возможность разработать практически неограниченное количество различных функций управления устройством.

И драйвер, и приложение пользователя различают, какую функцию управления устройством вызвать, при помощи IOCTL-кодов. Такой код представляет собой обыкновенное 32-разрядное число. Для удобства ему директивой #define задают какое-то понятное имя. Например, в нашем случае зададим IOCTL-код, при получении которого драйвер будет возвращать количество памяти "на борту" PCI-устройства.

#define XDSPDRV_IOCTL_GETMEMSIZE 0x800

Если при чтении драйверу посылается IRP-пакет со старшим кодом функции IRP_MJ_READ, при записи — IRP_MJ_WRITE, то при вызове функции DeviceIOControl для нашего устройства драйвер получает пакет со старшим кодом IRP_MJ_IOCONTROL и младшим — код самой IOCTL-функции. Метод DeviceControl вызывается при получении драйвером IRP со старшим кодом IRP_MJ_DEVICE_CONTROL. Она действует подобно методу StartIo. В зависимости от кода IOCTL производится вызов соответствующей функции.