Метод IDiscFormat2::get_MediaHeuristicallyBlank (imapi2.h)
Пытается определить, является ли носитель пустым, с помощью эвристики (в основном для DVD+RW и DVD-ОЗУ).
Синтаксис
HRESULT get_MediaHeuristicallyBlank(
[out] VARIANT_BOOL *value
);
Параметры
[out] value
VARIANT_TRUE, если диск, скорее всего, будет пустым; Иначе; VARIANT_FALSE.
Возвращаемое значение
S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:
| Код возврата | Описание |
|---|---|
|
Недопустимый указатель.
Значение: 0x80004003 |
|
Неуказанным сбоем.
Значение: 0x80004005 |
|
Не удалось выделить необходимую память.
Значение: 0x8007000E |
|
Один или несколько аргументов недопустимы.
Значение: 0x80070057 |
|
Запрошенная страница функции поддерживается, но не помечается как текущая.
Значение: 0xC0AA020B |
|
Устройству не удалось принять команду в течение времени ожидания. Это может быть вызвано тем, что устройство перешло в несогласованное состояние, или может потребоваться увеличить время ожидания для команды.
Значение: 0xC0AA020D |
|
Устройство сообщило непредвиденные или недопустимые данные для команды.
Значение: 0xC0AA02FF |
|
Носитель вставляется вверх дном.
Значение: 0xC0AA0204 |
|
Диск сообщил, что он находится в процессе подготовки. Повторите запрос позже.
Значение: 0xC0AA0205 |
|
На устройстве нет носителя.
Значение: 0xC0AA0202 |
|
В настоящее время форматируется носитель. Дождитесь завершения формата, прежде чем пытаться использовать носитель.
Значение: 0xC0AA0206 |
|
Диск сообщил, что он выполняет длительную операцию, например завершает запись. Диск может быть непригодным для использования в течение длительного периода времени.
Значение: 0xC0AA0207 |
|
Сбой записи, так как диск не получил данные достаточно быстро, чтобы продолжить запись. Эта проблема может быть решена при перемещении исходных данных на локальный компьютер, снижении скорости записи или включении параметра "недостаточно свободного буфера".
Значение: 0xC0AA0300 |
|
Носитель несовместим или имеет неизвестный физический формат.
Значение: 0xC0AA0203 |
|
Структура DVD отсутствует. Это может быть вызвано несовместимыми используемыми дисками или средой.
Значение: 0xC0AA020E |
|
Устройство сообщило, что запрошенная страница режима (и тип) отсутствует.
Значение: 0xC0AA0201 |
|
Диск сообщил, что сочетание параметров, предоставленных на странице режима для команды MODE SELECT, не поддерживается.
Значение: 0xC0AA0208 |
|
Диск сообщил, что носитель защищен от записи.
Значение: 0xC0AA0209 |
|
Скорость носителя несовместима с устройством. Это может быть вызвано использованием носителя с более высокой или более низкой скоростью, чем диапазон поддерживаемых устройством скоростей.
Значение: 0xC0AA020F |
|
Указанный дескриптор недопустим.
Значение: 6 |
|
Указанный сетевой ресурс или устройство больше не доступны.
Значение: 55 |
|
Устройство, связанное с этим устройством записи во время последней операции, было заблокировано исключительно, что привело к сбою этой операции.
0xC0AA0210 |
Комментарии
Этот метод проверяет, например, подключенную файловую систему на устройстве, проверяя заполнение первого и последнего 2 МБ диска нулями, а также другие проверки, связанные с носителем. Эти проверки помогут определить, могут ли на носителе содержаться файлы, которые не могут быть физически удалены до пустого состояния.
Чтобы проверка, что диск пуст, вызовите метод IDiscFormat2::get_MediaPhysicallyBlank.
Требования
| Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | imapi2.h |