структура PERSISTENT_RESERVE_COMMAND (ntddstor.h)

Статья
02/07/2025

Структура PERSISTENT_RESERVE_COMMAND используется вместе с запросами IOCTL_STORAGE_PERSISTENT_RESERVE_IN и IOCTL_STORAGE_PERSISTENT_RESERVE_OUT для получения и контроля сведений о постоянных резервированиях и ключах резервирования, активных на сервере устройства.

Синтаксис

typedef struct _PERSISTENT_RESERVE_COMMAND {
  ULONG Version;
  ULONG Size;
  union {
    struct {
      UCHAR  ServiceAction : 5;
      UCHAR  Reserved1 : 3;
      USHORT AllocationLength;
    } PR_IN;
    struct {
      UCHAR ServiceAction : 5;
      UCHAR Reserved1 : 3;
      UCHAR Type : 4;
      UCHAR Scope : 4;
      UCHAR ParameterList[0];
    } PR_OUT;
  } DUMMYUNIONNAME;
} PERSISTENT_RESERVE_COMMAND, *PPERSISTENT_RESERVE_COMMAND;

Члены

Version

Версия этой структуры.

Size

Размер этой структуры.

DUMMYUNIONNAME

DUMMYUNIONNAME.PR_IN

DUMMYUNIONNAME.PR_IN.ServiceAction

Код действия службы для этого запроса IOCTL_STORAGE_PERSISTENT_RESERVE_IN. PR_IN. ServiceAction может быть одним из следующих значений: RESERVATION_ACTION_READ_KEYS RESERVATION_ACTION_READ_RESERVATIONS

DUMMYUNIONNAME.PR_IN.Reserved1

Скрытный. Должно быть равно нулю.

DUMMYUNIONNAME.PR_IN.AllocationLength

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

DUMMYUNIONNAME.PR_OUT

DUMMYUNIONNAME.PR_OUT.ServiceAction

Код действия службы для этого запроса IOCTL_STORAGE_PERSISTENT_RESERVE_OUT. PR_OUT. ServiceAction может быть одним из следующих значений:

RESERVATION_ACTION_REGISTER
RESERVATION_ACTION_RESERVE
RESERVATION_ACTION_RELEASE
RESERVATION_ACTION_CLEAR
RESERVATION_ACTION_PREEMPT
RESERVATION_ACTION_PREEMPT_ABORT
RESERVATION_ACTION_REGISTER_IGNORE_EXISTING

DUMMYUNIONNAME.PR_OUT.Reserved1

Скрытный. Должно быть равно нулю.

DUMMYUNIONNAME.PR_OUT.Type

Значение, указывающее характеристики постоянного резервирования. PR_OUT. Тип может быть одним из следующих значений:

RESERVATION_TYPE_WRITE_EXCLUSIVE
RESERVATION_TYPE_EXCLUSIVE
RESERVATION_TYPE_WRITE_EXCLUSIVE_REGISTRANTS
RESERVATION_TYPE_EXCLUSIVE_REGISTRANTS

DUMMYUNIONNAME.PR_OUT.Scope

Значение, указывающее, применяется ли постоянное резервирование ко всей логической единице или определенному элементу логического блока. PR_OUT. Область может быть одним из следующих значений:

RESERVATION_SCOPE_LU
RESERVATION_SCOPE_ELEMENT

DUMMYUNIONNAME.PR_OUT.ParameterList[0]

Пространство для дополнительных параметров команды SCSI Persistent Reserve Out.

Замечания

Поведение устройства хранения при получении команды SCSI Persistent Reserve In или команды SCSI Persistent Reserve Out описано в спецификации основных команд SCSI (SPC-2).

Требования

Требование	Ценность
заголовка	ntddstor.h (include Ntddstor.h)

См. также

IOCTL_STORAGE_PERSISTENT_RESERVE_IN

IOCTL_STORAGE_PERSISTENT_RESERVE_OUT

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