Функция SetTapeParameters (winbase.h)

Статья
08/27/2023

Функция SetTapeParameters указывает размер блока ленты или настраивает ленточное устройство.

Синтаксис

DWORD SetTapeParameters(
  [in] HANDLE hDevice,
  [in] DWORD  dwOperation,
  [in] LPVOID lpTapeInformation
);

Параметры

[in] hDevice

Дескриптор устройства, для которого задаются сведения о конфигурации. Этот дескриптор создается с помощью функции CreateFile .

[in] dwOperation

Тип устанавливаемых сведений. Этот параметр должен иметь одно из следующих значений.

Значение	Значение
SET_TAPE_DRIVE_INFORMATION 1L	Задает сведения об устройстве, указанные в lpTapeInformation.
SET_TAPE_MEDIA_INFORMATION 0L	Задает сведения о ленте, заданные параметром lpTapeInformation .

[in] lpTapeInformation

Указатель на структуру, содержащую устанавливаемые сведения. Если параметр dwOperation имеет SET_TAPE_MEDIA_INFORMATION, lpTapeInformation указывает на структуру TAPE_SET_MEDIA_PARAMETERS .

Если dwOperation имеет SET_TAPE_DRIVE_INFORMATION, lpTapeInformation указывает на TAPE_SET_DRIVE_PARAMETERS структуру.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, она может вернуть один из следующих кодов ошибок.

Ошибка	Описание
ERROR_BEGINNING_OF_MEDIA 1102L	Попытка получить доступ к данным до начала среднего маркера завершилась сбоем.
ERROR_BUS_RESET 1111L	В шине обнаружено условие сброса.
ERROR_DEVICE_NOT_PARTITIONED 1107L	Не удалось найти сведения о секции при загрузке ленты.
ERROR_END_OF_MEDIA 1100L	Маркер конца ленты был достигнут во время операции.
ERROR_FILEMARK_DETECTED 1101L	Метка файла была достигнута во время операции.
ERROR_INVALID_BLOCK_LENGTH 1106L	Неправильный размер блока на новой ленте в многотомном разделе.
ERROR_MEDIA_CHANGED 1110L	Лента, которая находилась в диске, была заменена или удалена.
ERROR_NO_DATA_DETECTED 1104L	Маркер конца данных был достигнут во время операции.
ERROR_NO_MEDIA_IN_DRIVE 1112L	На диске нет носителя.
ERROR_NOT_SUPPORTED 50L	Драйвер ленты не поддерживает запрошенную функцию.
ERROR_PARTITION_FAILURE 1105L	Не удалось секционировать ленту.
ERROR_SETMARK_DETECTED 1103L	Метка была достигнута во время операции.
ERROR_UNABLE_TO_LOCK_MEDIA 1108L	Не удалось заблокировать механизм извлечения.
ERROR_UNABLE_TO_UNLOAD_MEDIA 1109L	Попытка выгрузить ленту завершилась сбоем.
ERROR_WRITE_PROTECT 19L	Носитель защищен от записи.

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

GetTapeParameters

TAPE_SET_DRIVE_PARAMETERS

TAPE_SET_MEDIA_PARAMETERS

Поделиться через