Метод IDiscRecorder::QueryMediaInfo (imapi.h)
Извлекает сведения о текущем подключенном носителе, например общее количество блоков, используемых на носителе.
Синтаксис
HRESULT QueryMediaInfo(
[out] byte *pbSessions,
[out] byte *pbLastTrack,
[out] ULONG *ulStartAddress,
[out] ULONG *ulNextWritable,
[out] ULONG *ulFreeBlocks
);
Параметры
[out] pbSessions
Количество сеансов на диске.
[out] pbLastTrack
Отслеживание номера последней дорожки предыдущего сеанса.
[out] ulStartAddress
Начальный адрес последней дорожки предыдущего сеанса.
[out] ulNextWritable
Адрес, с которого начинается запись.
[out] ulFreeBlocks
Количество блоков, доступных для записи.
Возвращаемое значение
S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:
Комментарии
Использование этого метода позволяет вычислять такие параметры, как объем свободного пространства, оставшееся на диске, без использования параметра на активном устройстве записи диска, что приводит к монопольным открытиям. Общий размер диска можно вычислить, суммируя следующий доступный для записи адрес и свободные блоки.
Требования
Минимальная версия клиента | Windows XP [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Целевая платформа | Windows |
Header | imapi.h |
Библиотека | Uuid.lib |
DLL | Actxprxy.dll |