Укрощение строптивого… CD-ROM
Алексей Фоминов
Кто не мечтает о быстром CD-ROM? Быстрый CD-ROM – это хорошо… с одной стороны. А если на компакт-диске появилась трещина? Быстрый CD-ROM – это уже нехорошо. На скорости 52х такой компакт-диск читать просто опасно. А если на этом диске жизненно важные данные? Выход есть. Просто снизить скорость привода. Если вы знакомы с языком программирования Object Pascal, тогда читайте далее.
Использование интерфейса SCSI
SCSI (Small Computer System Interface - интерфейс малой компьютерной системы) – шина ввода/вывода, которая разрабатывалась как метод соединения нескольких классов периферийных устройств в главную систему, не требующий внесения модификации в общие аппаратные средства и программное обеспечение.
Поскольку цель данной статьи рассказать читателю о том, как программно управлять устройствами, которые подключаются к SCSI-шине, а не о том, как написать драйвер SCSI-устройства, описывать технические особенности шины SCSI и её отличие от IDE я не буду.
Каким же образом операционная система Windows общается со SCSI-устройствами?
Это зависит от версии операционной системы. В системах семейства Windows 9х (95, 98, 98SE, Me) применяется ASPI (Advanced SCSI Programmer Interface – улучшенный интерфейс программирования SCSI). В стандартную поставку этих операционных систем входят ASPI-драйвер и библиотека для работы с ним, разработанные фирмой Adaptec. В системах семейства Windows NT (NT 4.0, 2000, XP, Server) используется SPTI (SCSI Pass Through Interface – интерфейс передачи через SCSI). То есть, в NT-системах компания Майкрософт полностью отказалась от продукта фирмы Adaptec и создала свой интерфейс общения со SCSI-устройствами. Принесло ли это пользу пользователям? Вряд ли. На мой субъективный взгляд, рядовому пользователю всё равно, как происходит доступ к SCSI, ему важно, чтобы всё работало правильно. Принесло ли это пользу разработчикам программного обеспечения? Однозначно нет. Теперь, разрабатывая приложения для управления SCSI-устройствами, разработчик должен либо создавать две версии своего продукта (одну для Win9x, другую для WinNT), либо включать поддержку двух интерфейсов в свой продукт, что вряд ли является целесообразным с точки зрения размера программы.
Какой из двух интерфейсов лучше, мне сказать трудно. Отмечу лишь то, что программа Nero использует ASPI-драйвер, специально разработанный для неё фирмой Adaptec.
Рассмотрим сначала программирование с помощью интерфейса ASPI, на примере управления приводом CD-ROM/R/RW.
Предполагается, что читатель умеет работать с динамически компонуемыми библиотеками (dll). Как вы будете подключать библиотеку для работы с ASPI-драйвером wnaspi32.dll (статически или динамически) – дело ваше, главное, чтобы ваше приложение правильно импортировало из этой библиотеки необходимые нам функции.
Я подключал эту библиотеку статически и импорт нужных нам функций у меня выглядел так:
function GetASPI32SupportInfo:DWORD; external 'wnaspi32.dll'
name 'GetASPI32SupportInfo';
function SendASPI32Command(LPSRB:Pointer):DWORD; external 'wnaspi32.dll'
name 'SendASPI32Command'.
Функция GetASPI32SupportInfo инициализирует ASPI и возвращает информацию об основной конфигурации. При успешном выполнении она возвращает двойное слово (DWORD), в котором старший байт младшего слова содержит статус ASPI, а младший байт – количество устройств (адаптеров), поддерживающих ASPI. Байт статуса может содержать следующие значения:
$01 – выполнено без ошибок;
$E8 – нет адаптеров;
$E2 – не может быть выполнено под управлением Windows 3.1;
$E3 – неправильная установка ASPI, или имеются конфликты ресурсов;
$E7 – установка ASPI нарушена (требуется повторная установка);
$E9 – недостаточно системных ресурсов для инициализации ASPI;
$E4 – общий внутренний сбой ASPI.
Количество возвращенных адаптеров представляет собой количество логических шин, а не физических адаптеров. Для адаптеров с единственной шиной количество адаптеров и количество логических шин идентичны.
Функция SendASPI32Command оперирует со всеми SCSI-запросами ввода/вывода. Каждый SCSI-запрос использует SCSI Request Block (SRB – Блока Запроса SCSI), определяющий операцию ASPI, которую нужно выполнить.
Параметр, передаваемый функции SendASPI32Command – указатель на определённую структуру. Описание этих структур приведено ниже.
type
SRB_HAInquiry = packed record
SRB_Cmd: Byte; // код команды ASPI (константа SC_HA_INQUIRY = $00)
SRB_Status, // байт статуса ASPI команды
SRB_HaId, // номер адаптера ASPI
SRB_Flags: Byte; // зарезервировано, должно быть 0
SRB_Hdr_Rsvd: Dword; // зарезервировано, должно быть 0
HA_Count: Byte; // количество адаптеров
HA_SCSI_ID: Byte; // ID SCSI-адаптера
HA_ManagerId: array [0..15] of Byte; // строка, описывающая менеджер
HA_Identifier: array [0..15] of Byte; // строка, описывающая адаптер
HA_Unique: array [0..15] of Byte; // уникальные параметры адаптера
HA_Rsvd1: Word; // зарезервировано, должно быть 0
end;
PSRB_HAInquiry = ^SRB_HAInquiry;
TSRB_HAInquiry = SRB_HAInquiry;
Структура TSRB_HAInquiry используется для получения информации о физических SCSI-адаптерах.
type
SRB_GDEVBlock = packed record
SRB_Cmd, // код команды ASPI (константа SC_GET_DEV_TYPE = $01);
SRB_Status, // байт статуса ASPI команды;
SRB_HaId, // номер адаптера ASPI;
SRB_Flags: Byte; // зарезервировано, должно быть 0;
SRB_Hdr_Rsvd: Dword; // зарезервировано, должно быть 0;
SRB_Target, // ID объекта SCSI;
SRB_Lun, // Logical Unit Number (LUN - логический номер устройства);
SRB_DeviceType, // тип периферийного устройства;
SRB_Rsvd1: Byte; // зарезервировано, должно быть 0;
end;
TSRB_GDEVBlock = SRB_GDEVBlock;
PSRB_GDEVBlock = ^SRB_GDEVBlock;
Структура TSRB_GDEVBlock используется для идентификации устройств на шине SCSI.
type
SRB_ExecSCSICmd = packed record
SRB_Cmd, // код команды ASPI (константа SC_EXEC_SCSI_CMD = $02)
SRB_Status, // байт статуса ASPI команды
SRB_HaId, // номер адаптера ASPI
SRB_Flags: Byte; // флаги запроса ASPI
SRB_Hdr_Rsvd: Dword; // зарезервировано, должно быть 0
SRB_Target, // ID объекта SCSI
SRB_Lun: Byte; // Logical Unit Number (LUN - логический номер устройства)
SRB_Rsvd1: Word; // зарезервировано для выравнивания
SRB_BufLen: Dword; // длина буфера
SRB_BufPointer: Pointer; // указатель на буфер данных
SRB_SenseLen, // длина значения;
SRB_CDBLen, // длина Command Descriptor Block – блока дескриптора команды
SRB_HaStat, // статус адаптера
SRB_TargStat: Byte; // статус объекта
SRB_PostProc, // указатель на функцию постинга (см.ниже)
SRB_Rsvd2: Pointer; // зарезервировано, должно быть 0;
SRB_Rsvd3, // зарезервировано для выравнивания
CDBByte: array [0..15] of byte; // SCSI Command Descriptor Block
// буфер значения для SCSI-запроса
SenseArea: array [0..SENSE_LEN + 1] of byte;
end;
TSRB_ExecSCSICmd = SRB_ExecSCSICmd;
PSRB_ExecSCSICmd = ^SRB_ExecSCSICmd;
Структура TSRB_ExecSCSICmd используется для выполнения команд ввода/вывода. Константа SENSE_LEN (длина буфера значения) по умолчанию равна 14.
На мой взгляд, теории пока достаточно. Перейду к практике.
Для начала инициализируем ASPI.
function GetASPI: Integer;
var
dwSupportInfo: DWORD;
byASPIStatus,byHACount: Byte;
begin
Result := 0;
dwSupportInfo := GetASPI32SupportInfo;
byASPIStatus := HIBYTE(LOWORD(dwSupportInfo)); // статус ASPI
byHACount := LOBYTE(LOWORD(dwSupportInfo)); // количество адаптеров
case byASPIStatus of
SS_COMP: Result := Integer(byHACount);
SS_NO_ADAPTERS: ShowMessage('ASPI-контроллеры не обнаружены!');
SS_ILLEGAL_MODE: ShowMessage(
'ASPI не может быть выполнен под управлением Windows 3.1!');
SS_NO_ASPI: ShowMessage(
'Неправильная установка ASPI, или имеются конфликты ресурсов!');
SS_MISMATCHED_COMPONENTS: ShowMessage(
'Установка ASPI нарушена! Установите повторно, пожалуйста!');
SS_INSUFFICIENT_RESOURCES: ShowMessage(
'Недостаточно системных ресурсов для инициализации ASPI!');
SS_FAILED_INIT: ShowMessage('Общий внутренний сбой ASPI!');
end;
end;
Итак, мы получили информацию об имеющихся SCSI-адаптерах. Теперь выделим из их числа (если их несколько) устройства CD-ROM/R/RW. Для этого создадим вспомогательные структуры: TCDROM и TCDROMs.
type
TCDROM=record
HaID, // номер адаптера ASPI
Target, // ID объекта SCSI
Lun: Byte; // логический номер устройства
DriveLetter: string; // буквенное обозначение диска
VendorID, // идентификатор производителя
ProductID, // идентификатор продукта
Revision, // изменение
VendorSpec, // спецификация производителя
Description: string; // описание
end;
Тип TCDROM будет хранить необходимые нам данные об устройствах CD-ROM.
type
TCDROMs=record
CdromCount: Byte;
Cdroms: array [Byte] of TCDROM;
end;
Поскольку у некоторых пользователей может быть подключено несколько CD-ROM, мы объявили тип TCDROMs, содержащий в себе информацию о количестве CD-ROM и массив элементов TCDROM. А теперь давайте напишем функцию для определения всех имеющихся в системе устройств CD-ROM, объявив перед этим глобальную переменную Cdroms: TCDROMs.
// в качестве параметра передаётся количество всех SCSI-адаптеров,
// имеющихся в системе. Результат работы функции – количество CD-ROM.
function GetCDROMs(var Adapters:Byte): Integer;
var
sh: TSRB_HAInquiry;
sd: TSRB_GDEVBlock;
maxTgt: Byte;
H, T, L: byte;
Begin
Result := 0;
if Adapters = 0 then
exit; // если количество адаптеров 0 – выходим
// начинаем перебирать все адаптеры
for H := 0 to Adapters - 1 do
begin
FillChar(sh,sizeof(sh),0); // инициализируем структуру TSRB_HAInquiry
// (константа SC_HA_INQUIRY = $00) запрос ASPI для получения информации
// об адаптерах.
sh.SRB_Cmd := SC_HA_INQUIRY;
sh.SRB_HaID := H;
SendASPI32Command(@sh); // посылаем ASPI команду
if sh.SRB_Status=SS_COMP then // если выполнено без ошибок, тогда:
begin
// четвёртый байт уникальных параметров определяет максимальное
// количество объектов SCSI
maxTgt := sh.HA_Unique[3];
// если этот байт равен 0, тогда присваиваем переменной максимально
// возможное значение (константа MAXTARG=7)
if maxTgt=0 then maxTgt := MAXTARG;
for T := 0 to maxTgt-1 do // начинаем перебирать все объекты SCSI
begin
for L := 0 to MAXLUN-1 do // и все логические номера устройств
begin
// инициализируем структуру TSRB_GDEVBlock
FillChar(sd,sizeof(sd),0);
// команда запрашивает тип устройства для объекта SCSI (константа
// SC_GET_DEV_TYPE = $01)
sd.SRB_Cmd := SC_GET_DEV_TYPE;
sd.SRB_HaID := H;
sd.SRB_Target := T;
sd.SRB_Lun := L;
SendASPI32Command(@sd); // посылаем ASPI-команду
// если выполнено без ошибок, и устройство является CD-ROM,
// заполняем переменную Cdroms.
if (sd.SRB_Status=SS_COMP) and (sd.SRB_DeviceType=DTYPE_CDROM) then
begin
Cdroms.Cdroms[Cdroms.CdromCount].HaID := H;
Cdroms.Cdroms[Cdroms.CdromCount].Target := T;
Cdroms.Cdroms[Cdroms.CdromCount].Lun := L;
// получаем информацию об этом CD-ROM
CdromInfo(Cdroms.CdromCount);
// увеличиваем счётчик количества устройств CD-ROM
inc(Cdroms.CdromCount);
end;
end;
end;
end;
end;
Result := Cdroms.CdromCount; // присваиваем результату функции количество CD-ROM
end;
Вы, наверное, обратили внимание на то, что в коде используется процедура CdromInfo. Это процедура, с помощью которой, мы получаем информацию о нашем CD-ROM. Перед тем, как привести её описание, я хочу рассказать вам о том, как происходит управление SCSI-устройствами посредством специальных команд, и как при этом используется структура TSRB_ExecSCSICmd.
Вот поля структуры TSRB_ExecSCSICmd, на которые нужно, прежде всего, обратить внимание: SRB_Cmd, SRB_Flags, SRB_CDBLen, CDBByte. Поле SRB_Cmd всегда должно содержать значение SC_EXEC_SCSI_CMD. Поле SRB_Flags должно определять направление передачи данных. Если данные передаются из SCSI-устройства в приложение, используется шестнадцатиричное значение $08 (определим это значение как константу SRB_DIR_IN). Если происходит обратная передача данных (от приложения к SCSI-устройству), используется шестнадцатиричное значение $10 (определим это значение как константу SRB_DIR_OUT). В зависимости от посылаемой команды, поле SRB_CDBLen может содержать значения: 6, 10 или 12. Массив байт CDBByte подробно описывает параметры выполняемой команды. Значение массива различно для всех команд. Замечу лишь, то, что нулевой байт этого массива всегда определяет код команды. Какие команды я имею в виду? Например: команда установки скорости CD-привода, команда записи CD-R или CD-RW-диска, команды управления аудио-CD (Play, Pause, Stop и так далее).
Существуют SCSI-команды, которые поддерживают все устройства, и есть команды, которые специфичны для определённого типа устройств. Первая команда, которую мы рассмотрим, команда INQUIRY, является обязательной для всех устройств. Она запрашивает информацию о SCSI-устройстве. А теперь собственно перейдём к коду процедуры:
// параметр, передаваемый процедуре – номер CD-ROM.
procedure CdromInfo(const Number: Byte);
var
// буфер будет содержать информацию о приводе
buffer: array [1..100] of Char;
begin
// инициализируем буфер (просто обнуляем его)
Fillchar(buffer, sizeof(buffer), 0);
// инициализируем структуру TSRB_ExecSCSICmd (глобальная переменная Srb)
Fillchar(Srb, sizeof(TSRB_ExecSCSICmd), 0);
hEvent := CreateEvent(nil, true, false, nil); // создаём событие
ResetEvent(hEvent); // переключаем на наше событие
with Srb do
begin
SRB_Cmd := SC_EXEC_SCSI_CMD;
SRB_HaId := Cdroms.Cdroms[Number].HaID;
SRB_Target := Cdroms.Cdroms[Number].Target;
SRB_Lun := Cdroms.Cdroms[Number].Lun;
// здесь добавляется ещё один флаг SRB_EVENT_NOTIFY ($40), уведомляющий
// систему о событии
SRB_Flags := SRB_DIR_IN or SRB_EVENT_NOTIFY;
SRB_BufLen := sizeof(buffer); // указываем размер буфера
SRB_BufPointer := @buffer; // определяем указатель на наш буфер
SRB_SenseLen := SENSE_LEN; // определяем длину буфера значения
SRB_CDBLen := 6; // эта команда – шестибайтная
SRB_PostProc := Pointer(hEvent); // процедура постинга – созданное событие
CDBByte[0] := $12; // код команды INQUIRY
// сюда помещаем старший байт длины буфера
CDBByte[3] := HIBYTE(sizeof(buffer));
// а сюда помещаем младший байт длины буфера
CDBByte[4] := LOBYTE(sizeof(buffer));
end;
// после того как заполнили структуру TSRB_ExecSCSICmd, посылаем
// ASPI-команду
dwASPIStatus := SendASPI32Command(@Srb);
if dwASPIStatus=SS_PENDING then
WaitForSingleObject(hEvent, INFINITE); // ждём окончания обработки команды
CloseHandle(hEvent); // закрываем хэндл события
// если команда выполнена без ошибок, заполняем данные об устройстве:
if Srb.SRB_Status=SS_COMP then
begin
with Cdroms.Cdroms[Number] do
begin
// восемь байт буфера, начиная с девятого, содержат
// идентификатор производителя
VendorID := PChar(Copy(buffer, 9, 8));
// шестнадцать байт, начиная с семнадцатого, содержат
// идентификатор продукта
ProductID := PChar(Copy(buffer, 17, 16));
// четыре байта, начиная с тридцать третьего, содержат номер
// изменения продукта
Revision := PChar(Copy(buffer, 33, 4));
// двадцать байт, начиная с тридцать седьмого, содержат
// спецификацию производителя
VendorSpec := PChar(Copy(buffer, 37, 20));
end;
end;
end;
Я понимаю, что многим эта процедура покажется неинтересной – я её привёл лишь для того, чтобы показать основы работы со SCSI-устройствами.
Следующие две процедуры, на мой взгляд, заинтересуют большее число пользователей. Уверен, многие из вас постоянно пользуются, или пользовались ранее, программами, управляющими скоростью привода CD-ROM (например, программой CDSlow). Хотите написать подобную программу сами? Позвольте помочь вам кодом, состоящим из двух процедур, одна из которых определяет текущую и максимально поддерживаемую скорость привода, а другая устанавливает необходимую пользователю скорость.
Для этого я воспользовался SCSI-командой MODE SENSE(10). Цифра десять означает, что команда десятибайтная. Это важно, потому что существует такая же шестибайтная команда. В принципе, можно было бы воспользоваться и шестибайтной командой, но поскольку команда MODE SENSE(10) более совершенна, я остановил свой выбор на ней. Итак, для чего же нужна данная команда? Всё просто, она читает значения режимов (Mode Sense), установленных для SCSI-устройства. Существуют так называемые страницы режима (Mode Page), в которых хранится некоторая информация (например, параметры скорости привода, параметры для записи CD-R/RW-дисков и многое другое). Доступ к этим страницам осуществляется по их коду с использованием команды MODE SENSE.
Опишем вспомогательный тип TCDSpeeds.
type
TCDSpeeds=record
MaxSpeed, // максимальная скорость чтения
CurrentSpeed, // текущая скорость чтения
MaxWriteSpeed, // максимальная скорость записи
CurrentWriteSpeed:integer; // текущая скорость записи
end;
Теперь, я думаю, понятно для чего эта структура нужна.
// какие параметры передавать функции, объяснять, по моему, не надо
function GetCDSpeeds(Host,Target,Lun:Byte):TCDSpeeds;
var
buffer: array [0..29] of Byte; // буфер для принимаемых данных
Здесь я сделаю небольшое пояснение относительно размера буфера. Данные, возвращаемые при использовании страницы режима CD Capabilities and Mechanical Status Page, имеют размер 20 байт. Но, как вы заметили, я использовал буфер размером 30 байт, и вот почему. Перед самой страницей режима, идут заголовок режима параметров, код страницы и её размер. Размер заголовка при использовании шестибайтной команды MODE SENSE составляет 4 байта, а при использовании команды MODE SENSE(10) – 8 байт.
Продолжим. Код, который уже встречался ранее, приведен без комментариев:
begin
hEvent := CreateEvent(nil, true, false, nil);
FillChar(buffer,sizeof(buffer),0);
FillChar(Srb,sizeof(TSRB_ExecSCSICmd),0);
Srb.SRB_Cmd := SC_EXEC_SCSI_CMD;
Srb.SRB_Flags := SRB_DIR_IN or SRB_EVENT_NOTIFY;
Srb.SRB_Target := Target;
Srb.SRB_HaId := Host;
Srb.SRB_Lun := Lun;
Srb.SRB_BufLen := sizeof(buffer);
Srb.SRB_BufPointer := @buffer;
Srb.SRB_SenseLen := SENSE_LEN;
Srb.SRB_CDBLen := $0A; // это десятибайтная команда
Srb.SRB_PostProc := Pointer(hEvent);
Srb.CDBByte[0] := $5A; // код команды MODE SENSE(10)
// код страницы CD Capabilities and Mechanical Status Page
Srb.CDBByte[2] := $2A;
Srb.CDBByte[7] := HIBYTE(sizeof(buffer));
Srb.CDBByte[8] := LOBYTE(sizeof(buffer));
ResetEvent(hEvent);
dwASPIStatus := SendASPI32Command(@Srb);
if dwASPIStatus=SS_PENDING then
WaitForSingleObject(hEvent,INFINITE);
if Srb.SRB_Status<>SS_COMP then
// если ошибка, обнуляем структуру TCDSpeeds
FillChar(Result,sizeof(TCDSpeeds),0);
else begin
// почему сумма байт делится на 176? 176 – это скорость передачи
// данных, равная одному килобайту в секунду.
Result.MaxSpeed := ((buffer[16] shl 8) + buffer[17]) div 176;
Result.CurrentSpeed := ((buffer[22] shl 8) + buffer[23]) div 176;
Result.MaxWriteSpeed := ((buffer[26] shl 8) + buffer[27]) div 176;
Result.CurrentWriteSpeed := ((buffer[28] shl 8) + buffer[29]) div 176;
end;
CloseHandle(hEvent);
end;
Итак, скорости мы определили, теперь нужно научиться ими управлять.
Для этого воспользуемся SCSI-командой SetCDSpeed.
// параметры ReadSpeed и WriteSpeed – скорость чтения и записи соответственно
function SetSpeed(
Host, Target, Lun : Byte;
ReadSpeed, WriteSpeed : integer) : boolean;
begin
if ReadSpeed=0 then
result := false
else
begin
hEvent := CreateEvent(nil, true, false, nil);
FillChar(Srb,sizeof(TSRB_ExecSCSICmd), 0);
Srb.SRB_Cmd := SC_EXEC_SCSI_CMD;
// обратите внимание здесь данные передаются из приложения в
// устройство (флаг SRB_DIR_OUT)
Srb.SRB_Flags := SRB_DIR_OUT or SRB_EVENT_NOTIFY;
Srb.SRB_Target := Target;
Srb.SRB_HaId := Host;
Srb.SRB_Lun := Lun;
Srb.SRB_SenseLen := SENSE_LEN;
Srb.SRB_CDBLen := $0C; // эта команда двенадцатибайтная
Srb.SRB_PostProc := Pointer(hEvent);
Srb.CDBByte[0] := $BB; // код команды Set CD Speed
// устанавливаем скорость чтения
Srb.CDBByte[2] := Byte((ReadSpeed * 176) shr 8);
Srb.CDBByte[3] := Byte(ReadSpeed * 176);
if WriteSpeed<>0 then // если привод пишущий
begin
// ...устанавливаем скорость записи
Srb.CDBByte[4] := Byte((WriteSpeed * 176) shr 8);
Srb.CDBByte[5] := Byte(WriteSpeed * 176);
end;
ResetEvent(hEvent);
dwASPIStatus := SendASPI32Command(@Srb);
if dwASPIStatus=SS_PENDING then
WaitForSingleObject(hEvent,INFINITE);
if Srb.SRB_Status<>SS_COMP then
result := false
else
result := true;
end;
end;
Напоследок хочу рассказать о том, как узнать все скорости, которые поддерживает привод. Разместите на форме компоненты TComboBox и TButton. В обработчике события OnClick компонента TButton поместите следующий код:
var
i : integer;
begin
ComboBox1.Items.Clear; // очищаем элементы выпадающего списка
with Cdroms.Cdroms[0] do // используем первый CD-ROM
begin
// открываем цикл от 1 до максимальной скорости привода
for i := 1 to GetCDSpeeds(HaID, Target, Lun).MaxSpeed do
begin
SetSpeed(HaID, Target, Lun, i, 0); // устанавливаем скорость, равную i
if i = GetCDSpeeds(HaID, Target, Lun).CurrentSpeed then
// сравниваем, если текущая скорость равна i, заносим это
// значение в выпадающий список
ComboBox1.Items.Add(IntToStr(i));
end;
end;
end;
Вот и всё. Следующая часть статьи посвящена работе с SPTI-интерфейсом.
Использование интерфейса SPTI
Итак, в предыдущей статье было рассказано, как управлять приводом CD-ROM, используя интерфейс ASPI.
Однако интерфейс ASPI поддерживается в операционных системах семейства Win9x, которые сейчас используются крайне редко. Здесь я расскажу о том, как осуществлять управление CD-ROM посредством SPTI-интерфейса, который поддерживается в операционных системах WinNT, 2000, XP, 2003 Server. Начну с описания основных структур, которые при этом понадобятся:
type
TScsiPassThrough = record
Length : Word; // Размер структуры TScsiPassThrough
ScsiStatus : Byte; // Статус SCSI-запроса
PathId : Byte; // Идентификатор SCSI-адаптера
TargetId : Byte; // Идентификатор объекта SCSI
Lun : Byte; // Logical Unit Number (LUN - логический номер устройства)
// Длина CDB (Command Descriptor Block – блока дескриптора команды)
CDBLength : Byte;
SenseInfoLength : Byte; // Длина буфера значения
DataIn : Byte; // Байт, определяющий тип запроса (ввод или вывод)
DataTransferLength : DWORD; // Размер передаваемых данных
TimeOutValue : DWORD; // Время ожидания запроса в секундах
DataBufferOffset : DWORD; // Смещение буфера данных
SenseInfoOffset : DWORD; // Смещение буфера значения
// SCSI Command Descriptor Block (Блок дескриптора команды)
CDB: array [0..15] of Byte;
end;
Следующая структура:
TScsiPassThroughWithBuffers = record
spt : TScsiPassThrough;
bSenseBuf : array [0..31] of Byte; // Буфер значения
bDataBuf : array [0..191] of Byte; // Буфер данных
end;
ScsiPassThroughWithBuffers=TScsiPassThroughWithBuffers;
PScsiPassThroughWithBuffers=^TScsiPassThroughWithBuffers;
Как видите, эта структура содержит тип TScsiPassThrough и два буфера. Для удобства мы будем использовать структуру TScsiPassThroughWithBuffers.
Теперь постараюсь объяснить принцип использования интерфейса SPTI.
Сначала, с помощью функции CreateFile, создаём хэндл для доступа к устройству. Затем заполняем данными структуру TScsiPassThroughWithBuffers. И, наконец, с помощью функции DeviceIoControl, посылаем устройству управляющий код.
Выглядит это примерно так:
procedure GetSPTIDrives; // Процедура получает информацию о CD-ROM
var
j : integer;
s : string;
len, returned : DWORD;
sptwb : TScsiPassThroughWithBuffers;
Cdroms : TCdroms; // Структура Tcdroms описана в предыдущей статье
const
SCSI_IOCTL_DATA_IN = 1;
IOCTL_SCSI_PASS_THROUGH = ($00000004 shl 16)
or (($0001 or $0002) shl 14) or ($0401 shl 2) or (0);
begin
// Кроме строки '.E : ', можно использовать, 'cdrom0', 'cdrom1' и т.д.
// в зависимости от количества устройств
hDevice := CreateFile('.E : ', GENERIC_READ or GENERIC_WRITE,
FILE_SHARE_READ or FILE_SHARE_WRITE,
nil, OPEN_EXISTING, 0, 0);
if hDevice=INVALID_HANDLE_VALUE then
ShowMessage('INVALID_HANDLE_VALUE');
sptwb.Spt.Length := sizeof(TSCSIPASSTHROUGH);
sptwb.Spt.CdbLength := 6; // Шестибайтная команда
sptwb.Spt.SenseInfoLength := 24;
// Команда будет получать данные от устройства (ввод)
sptwb.Spt.DataIn := SCSI_IOCTL_DATA_IN;
// Устанавливаем размер передаваемых данных
sptwb.Spt.DataTransferLength := sizeof(sptwb.bDataBuf);
sptwb.Spt.TimeOutValue := 10; // Время ожидания – 10 секунд
sptwb.Spt.DataBufferOffset := DWORD(@sptwb.bDataBuf)-DWORD(@sptwb);
sptwb.Spt.SenseInfoOffset := DWORD(@sptwb.bSenseBuf)-DWORD(@sptwb);
len := sptwb.Spt.DataBufferOffset+sptwb.spt.DataTransferLength;
// Команда INQUIRY вам уже известна по предыдущей статье
sptwb.Spt.CDB[0] := SCSI_INQUIRY;
sptwb.Spt.CDB[3] := HiByte(sizeof(sptwb.bDataBuf));
sptwb.Spt.CDB[4] := LoByte(sizeof(sptwb.bDataBuf));
if DeviceIoControl(hDevice, IOCTL_SCSI_PASS_THROUGH, @sptwb,
len, @sptwb, len, Returned, nil) and (sptwb.Spt.ScsiStatus = $00) then
begin
// Нижеследующие циклы предназначены для разделения информации о
// производителе, спецификации и т.д. Если вашей программе это не нужно,
// можно сделать так : ShowMessage(PChar(@sptwb.bDataBuf[8]));
s := '';
for j := 8 to 15 do
s := s + Chr(sptwb.bDataBuf[j]);
// Идентификатор производителя
Cdroms.Cdroms[Cdroms.ActiveCdrom].VendorID := s;
s := '';
for j := 16 to 31 do
s := s + Chr(sptwb.bDataBuf[j]);
Cdroms.Cdroms[Cdroms.ActiveCdrom].ProductID := s; // Идентификатор продукта
s := '';
for j := 32 to 35 do
s := s+chr(sptwb.bDataBuf[j]);
Cdroms.Cdroms[Cdroms.ActiveCdrom].Revision := s; // Номер изменения
s := '';
for j := 36 to 55 do
s := s+chr(sptwb.bDataBuf[j]);
// Спецификация производителя
Cdroms.Cdroms[Cdroms.ActiveCdrom].VendorSpec := s;
end;
end;
Если вы заметили, использование параметров PathId, TargetId и Lun для интерфейса SPTI не является обязательным (в отличие от ASPI). Поэтому, если вы всё же хотите, чтобы ваша программа определяла идентификатор SCSI-адаптера, идентификатор объекта SCSI и логический номер устройства, могу посоветовать воспользоваться таким кодом:
procedure Get_PathId_TargetId_Lun;
var
buf : array [0..1023] of Byte;
pscsiAddr:PSCSI_ADDRESS;
const
IOCTL_SCSI_GET_ADDRESS = $41018;
begin
ZeroMemory(@buf, sizeof(buf));
pscsiAddr := PSCSI_ADDRESS(@buf);
pscsiAddr^.Length := sizeof(TSCSI_ADDRESS);
if (DeviceIoControl(hDevice, IOCTL_SCSI_GET_ADDRESS, nil, 0,
pscsiAddr, sizeof(TSCSI_ADDRESS), returned, nil)) then
begin
Cdroms.Cdroms[Cdroms.ActiveCdrom].HaID := pscsiAddr^.PortNumber;
Cdroms.Cdroms[Cdroms.ActiveCdrom].Target := pscsiAddr^.TargetId;
Cdroms.Cdroms[Cdroms.ActiveCdrom].Lun := pscsiAddr^.Lun;
end else
ShowMessage(SysErrorMessage(GetLastError));
end;
В этом куске кода используется структура PSCSI_ADDRESS, которая выглядит следующим образом:
type
TSCSI_ADDRESS = record
Length : LongInt; // Размер структуры TSCSI_ADDRESS
PortNumber : Byte; // Номер адаптера SCSI
PathId : Byte; // Идентификатор адаптера SCSI
TargetId : Byte; // Идентификатор объекта SCSI
Lun : Byte; // Логический номер устройства
end;
SCSI_ADDRESS = TSCSI_ADDRESS;
PSCSI_ADDRESS = ^TSCSI_ADDRESS;
Как вы уже успели заметить, SCSI-команды для интерфейсов ASPI и SPTI одинаковы, поэтому необходимо знать лишь сами команды и заполнять соответствующим образом CDB (Command Descriptor Block). Для наглядности приведу пример использования интерфейса SPTI для установки скорости CD-ROM. Сравните этот код с таким же, но использующим интерфейс ASPI, и вы сами увидите все отличия.
function SPTISetSpeed(ReadSpeed, WriteSpeed:integer):Boolean;
var
spti:TScsiPassThroughWithBuffers;
const
SCSI_IOCTL_DATA_OUT = 0;
Rate = 176;
begin
spti.Spt.Length := sizeof(TSCSIPASSTHROUGH);
spti.Spt.CdbLength := 10;
spti.Spt.SenseInfoLength := 24;
spti.Spt.DataIn := SCSI_IOCTL_DATA_OUT;
spti.Spt.TimeOutValue := 10;
spti.spt.DataBufferOffset := DWORD(@spti.bDataBuf)-DWORD(@spti);
spti.spt.SenseInfoOffset := DWORD(@spti.bSenseBuf)-DWORD(@spti);
spti.Spt.DataTransferLength := sizeof(spti.bDataBuf);
spti.spt.CDB[0] := $BB;
spti.spt.CDB[2] := BYTE(ReadSpeed*Rate shr 8);
spti.spt.CDB[3] := BYTE(ReadSpeed*Rate);
if WriteSpeed<>0 then
begin
spti.spt.CDB[4] := BYTE(WriteSpeed*Rate shr 8);
spti.spt.CDB[5] := BYTE(WriteSpeed*Rate);
end else
spti.spt.CDB[4] := $FF;
spti.spt.CDB[5] := $FF;
if DeviceIoControl(hDevice, IOCTL_SCSI_PASS_THROUGH, @spti, len, @spti, len, returned, nil) and
(spti.spt.ScsiStatus=$00) then result := true
else
result := false;
end;
Думаю, данный код не нуждается в пояснениях.
Кстати, всё вышесказанное (в том числе и в предыдущей статье) относится не только к устройствам CD-ROM, но и к другим SCSI-устройствам. Отличия лишь в командах. Есть команды, которые обязательны для всех устройств (MODE SELECT, MODE SENSE, INQUIRY и т.д.), и есть команды, которые специфичны для разных типов устройств (BLANK – для устройств CD-RW, PRINT – для принтеров, SCAN – для сканеров, и т.д.).
Теперь вы знаете, как осуществляется управление устройствами, подключёнными к шине SCSI. Какой использовать интерфейс, ASPI или SPTI, или оба вместе – дело ваше. Могу сказать лишь, что для использования двух интерфейсов рациональнее будет либо создать два приложения для двух семейств операционных систем Windows, либо создать две отдельные библиотеки и подгружать их в зависимости от операционной системы, поскольку поддержка двух интерфейсов в одном приложении может отрицательно сказаться на его размере и объеме используемой оперативной памяти.
Список литературы
Для подготовки данной работы были использованы материалы с сайта http://www.rsdn.ru/