IOBlockStorageDriver

Обсуждение

Этот метод регистрирует размер блока носителей и блочное количество, затем вызывает instantiateMediaObject для инстанцирования мультимедийного объекта. Мультимедийный объект тогда присоединяется выше нас и регистрируется.

Этот метод может быть переопределен для управления тем, что происходит, когда вставляются новые носители. Реализация по умолчанию имеет дело с одним объектом IOMedia.

Обсуждение

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

Реализация этого метода обычно не переопределяется.

Обсуждение

Выделите структуру контекста для работы чтения-записи.

Обсуждение

breakUpRequest проверки метода, чтобы видеть, превышает ли входящий запрос наши ограничения передачи, и если так, разбивают запрос в меньшие подзапросы.

Этот метод является частью последовательности методов, вызванных для каждого запроса чтения-записи. Первым является prepareRequest, выделяющий и подготавливающий некоторый контекст к передаче; вторым является deblockRequest, выравнивающий передачу на блочных границах носителей; треть является breakUpRequest, разбивающим передачу в многократные подпередачи, когда превышены определенные аппаратные ограничения; четвертый executeRequest, реализующий фактическую передачу от устройства блочной системы хранения.

Реализация этого метода обычно не переопределяется.

Обсуждение

Этот метод выполняет большую часть работы в опросе относительно носителей, сначала вызывая reportMediaState метод устройства блочной системы хранения. Если reportMediaState сообщает, что никакое изменение в состоянии носителей, возвращается kIOReturnSuccess. Если состояние носителей действительно изменилось, вызов выполняется к mediaStateHasChanged для действия на событие.

Обсуждение

Эта функция должна быть вызвана до каждой операции чтения или операции записи, так, чтобы драйвер мог ограничить требуемое количество байта, по мере необходимости, встречать текущие пределы устройства. Такие пределы могли быть наложены устройством в зависимости от рабочих режимов, типов среды или транспортного протокола (например, ATA, SCSI).

В настоящее время этот метод не используется.

Обсуждение

Преобразуйте указанное байтовое смещение в физическое байтовое смещение относительно физического объекта хранения. Этот вызов должен только быть выполнен в контексте lockPhysicalExtents ().

Обсуждение

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

Этот метод является частью последовательности методов, вызванных для каждого запроса чтения-записи. Первым является prepareRequest, выделяющий и подготавливающий некоторый контекст к передаче; вторым является deblockRequest, выравнивающий передачу на блочных границах носителей; треть является breakUpRequest, разбивающим передачу в многократные подпередачи, когда превышены определенные аппаратные ограничения; четвертый executeRequest, реализующий фактическую передачу от устройства блочной системы хранения.

Реализация этого метода обычно не переопределяется.

Обсуждение

Этот метод обертывает вызов, чтобы завершить, разобрать штабель и объект IOMedia для носителей. Если «насильственный» истина, о мультимедийном объекте забудут, и initMediaState вызовут. Насильственное списывает, произошел бы, когда неисправимая ошибка происходит во время разрушения (например, возможно клиент все еще открыт), но мы должны все еще забыть о носителях.

Обсуждение

Удалите структуру контекста из работы чтения-записи.

Обсуждение

Извлеките носители от устройства. Драйвер ответственен за разъединение мультимедийного объекта, который это создало перед продолжением извлечения. Если разрушение перестало работать, ошибка должна быть возвращена.

Обсуждение

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

Этот метод является частью последовательности методов, вызванных для каждого запроса чтения-записи. Первым является prepareRequest, выделяющий и подготавливающий некоторый контекст к передаче; вторым является deblockRequest, выравнивающий передачу на блочных границах носителей; треть является breakUpRequest, разбивающим передачу в многократные подпередачи, когда превышены определенные аппаратные ограничения; четвертый executeRequest, реализующий фактическую передачу от устройства блочной системы хранения.

Обсуждение

Отформатируйте носители с указанной мощностью байта. Драйвер ответственен за разъединение мультимедийного объекта и воссоздание его.

Обсуждение

Этот метод возвращает строку, используемую для сравнения kIOBlockStorageDeviceTypeKey нашего провайдера. Этот метод вызывают от зонда.

Реализация по умолчанию этого метода возвращает kIOBlockStorageDeviceTypeGeneric.

Обсуждение

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

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

Обсуждение

Спросите драйвер о естественном размере блока носителей.

Обсуждение

Спросите драйвер о текущем состоянии носителей.

Обсуждение

Попросите, чтобы драйвер сообщил об одной из своих операционных статистик.

Обсуждение

Попросите, чтобы драйвер сообщил о своей операционной статистике.

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

Если буфер статистики не предоставляется или если максимальное количество является нулем, подпрограмма возвращает предложенное количество статистики вместо этого.

Обсуждение

handleClose метод закрывает доступ клиента к этому объекту.

Эта реализация заменяет определение IOService handleIsOpen ().

Обсуждение

handleIsOpen метод определяет, есть ли у указанного клиента или какого-либо клиента, если ни один не указан, в настоящее время открытое на этом объекте.

Эта реализация заменяет определение IOService handleIsOpen ().

Обсуждение

handleOpen метод предоставляет или отклоняет разрешение получить доступ к этому объекту заинтересованному клиенту. Параметром является значение IOStorageAccess, указывающее уровень желаемого доступа - читатель или читатель-писатель.

Этот метод может быть вызван, чтобы обновить или понизить уровень доступа для существующего клиента также. Предыдущий уровень доступа будет преобладать для обновлений тот сбой, конечно. Снижение никогда не должно перестать работать. Если новый уровень доступа должен совпасть со старым для данного клиента, этот метод ничего не сделает и возвратит успех. Во всех случаях, один, исключительное завершение на клиент ожидается для всех, открывается на клиент полученный.

Эта реализация заменяет определение IOService handleIsOpen ().

Обсуждение

Подготовьте драйвер блочной системы хранения к работе.

Это - то, где мультимедийный объект должен быть создан для фиксированных носителей, и дополнительно для съемных носителей.

Обратите внимание на то, что этот метод вызывают из запуска () подпрограммой; если этот метод возвращается успешно, он должен быть подготовлен принять любой APIs IOBlockStorageDriver.

Обсуждение

Обновите количество полной погрешности - используемый для статистики.

Реализация этого метода обычно не переопределяется.

Обсуждение

Обновите общее число повторных попыток - используемый для статистики.

Реализация этого метода обычно не переопределяется.

Обсуждение

Вызванный, когда носители не присутствует, этот метод отмечает состояние устройства, поскольку не наличие носителей представляет, не вращаемый и с разрешением записи.

Обсуждение

Этот метод создает точный тип желаемого объекта IOMedia. Это вызывает instantiateMediaObject. Подкласс может переопределить этот короткий метод для изменения типа мультимедийного объекта, который фактически инстанцируют.

Обсуждение

Этот метод создает объект IOMedia из предоставленных параметров. Это - удобный метод обернуть небольшое количество шагов для выполнения работы.

Обсуждение

Спросите драйвер, являются ли носители выбрасываемыми.

Обсуждение

Спросите драйвер, являются ли носители выбрасываемыми.

Обсуждение

Спросите драйвер, перезаписываемы ли носители.

Обсуждение

Заблокируйте содержание объекта хранения против перемещения временно, в целях получения физических степеней.

Обсуждение

Этот метод вызывают на изменении состояния носителей, т.е. поступлении или удалении. Если носители только что стали доступными, вызовы выполняются к recordMediaParameters и acceptNewMedia. Если носители только что ушли, вызов выполняется к decommissionMedia с насильственным набором параметра к истине. Насильственное разрушение необходимо для осуществления исчезновения носителей, независимо от заинтересованных клиентов.

Обсуждение

prepareRequest метод выделяет и подготавливает состояние к передаче.

Этот метод является частью последовательности методов, вызванных для каждого запроса чтения-записи. Первым является prepareRequest, выделяющий и подготавливающий некоторый контекст к передаче; вторым является deblockRequest, выравнивающий передачу на блочных границах носителей; треть является breakUpRequest, разбивающим передачу в многократные подпередачи, когда превышены определенные аппаратные ограничения; четвертый executeRequest, реализующий фактическую передачу от устройства блочной системы хранения.

Реализация этого метода обычно не переопределяется.

Обсуждение

Метод чтения является принимающим концом для всех запросов чтения от платформы хранения (через мультимедийный объект, создаваемый этим драйвером).

Этот метод инициирует последовательность методов (этапы) для каждого запроса чтения-записи. Первым является prepareRequest, выделяющий и подготавливающий некоторый контекст к передаче; вторым является deblockRequest, выравнивающий передачу на блочных границах носителей; треть является breakUpRequest, разбивающим передачу в многократные подпередачи, когда превышены определенные аппаратные ограничения; четвертый executeRequest, реализующий фактическую передачу от устройства блочной системы хранения.

Реализация этого метода обычно не переопределяется.

Обсуждение

Этот метод получает связанные с носителями параметры через вызовы к Транспортному Водительскому reportBlockSize, reportMaxValidBlock, и reportWriteProtection методы.

Обсуждение

Этот метод вызовут, если validateNewMedia возвратит False (таким образом отклоняющий новые носители. Когда носители отклоняются, поставщик может принять решение переопределить этот метод для управления поведением.

Реализация по умолчанию просто вызывает ejectMedia.

Обсуждение

Запросите, чтобы устройство ввело состояние ожидания. Устройство выйдет из этого состояния на следующем чтении или запишет запрос, или как это видит необходимый. Один пример для DVD-привода для вращения вниз, когда он вводит такое состояние ожидания и вращение по следующему запросу чтения от системы.

Обсуждение

Сбросьте кэшированные данные в объекте хранения, если таковые имеются, синхронно.

Обсуждение

Разблокируйте содержание объекта хранения для перемещения снова. Этот вызов должен сбалансировать успешный вызов к lockPhysicalExtents ().

Обсуждение

Удалите неиспользованные данные из объекта хранения при указанных байтовых смещениях, синхронно.

Обсуждение

Этот метод вызовут каждый раз, когда обнаруживаются новые носители. Возвратите true, чтобы принять, что носители или ложь отклоняют его (и вызывают rejectMedia). Поставщики могли бы переопределить этот метод для обработки защиты паролем для новых носителей.

Реализация по умолчанию всегда возвращается Правда, указание, что приняты носители.

Обсуждение

Метод записи является принимающим концом для всех запросов записи от платформы хранения (через мультимедийный объект, создаваемый этим драйвером).

Этот метод инициирует последовательность методов (этапы) для каждого запроса чтения-записи. Первым является prepareRequest, выделяющий и подготавливающий некоторый контекст к передаче; вторым является deblockRequest, выравнивающий передачу на блочных границах носителей; треть является breakUpRequest, разбивающим передачу в многократные подпередачи, когда превышены определенные аппаратные ограничения; четвертый executeRequest, реализующий фактическую передачу от устройства блочной системы хранения.

Реализация этого метода обычно не переопределяется.