PERSISTENT_RESERVE_COMMAND structure (ntddstor.h)

Article
02/26/2024

La structure PERSISTENT_RESERVE_COMMAND est utilisée avec les demandes IOCTL_STORAGE_PERSISTENT_RESERVE_IN et IOCTL_STORAGE_PERSISTENT_RESERVE_OUT pour obtenir et contrôler des informations sur les réservations persistantes et les clés de réservation actives au sein d’un serveur d’appareil.

Syntaxe

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;

Membres

Version

Version de cette structure.

Size

La taille de cette structure.

DUMMYUNIONNAME

DUMMYUNIONNAME.PR_IN

DUMMYUNIONNAME.PR_IN.ServiceAction

Code d’action de service pour cette demande IOCTL_STORAGE_PERSISTENT_RESERVE_IN. PR_IN. ServiceAction peut avoir l’une des valeurs suivantes : RESERVATION_ACTION_READ_KEYS RESERVATION_ACTION_READ_RESERVATIONS

DUMMYUNIONNAME.PR_IN.Reserved1

Réservé. Doit être zéro.

DUMMYUNIONNAME.PR_IN.AllocationLength

Nombre d’octets alloués à la liste de paramètres retournée.

DUMMYUNIONNAME.PR_OUT

DUMMYUNIONNAME.PR_OUT.ServiceAction

Code d’action de service pour cette demande IOCTL_STORAGE_PERSISTENT_RESERVE_OUT. PR_OUT. ServiceAction peut avoir l’une des valeurs suivantes :

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

Réservé. Doit être zéro.

DUMMYUNIONNAME.PR_OUT.Type

Valeur qui spécifie les caractéristiques de la réservation persistante. PR_OUT. Type peut être l’une des valeurs suivantes :

RESERVATION_TYPE_WRITE_EXCLUSIVE
RESERVATION_TYPE_EXCLUSIVE
RESERVATION_TYPE_WRITE_EXCLUSIVE_REGISTRANTS
RESERVATION_TYPE_EXCLUSIVE_REGISTRANTS

DUMMYUNIONNAME.PR_OUT.Scope

Valeur qui spécifie si la réservation persistante s’applique à l’unité logique entière ou à un élément spécifique de l’unité logique. PR_OUT. L’étendue peut être l’une des valeurs suivantes :

RESERVATION_SCOPE_LU
RESERVATION_SCOPE_ELEMENT

DUMMYUNIONNAME.PR_OUT.ParameterList[0]

Espace pour les paramètres de commande de réserve permanente SCSI supplémentaires.

Remarques

Le comportement du périphérique de stockage lors de la réception d’une commande SCSI Persistent Reserve In ou d’une commande SCSI Persistent Reserve Out est décrit dans la spécification SCSI Primary Commands - 2 (SPC-2).

Configuration requise

Condition requise	Valeur
En-tête	ntddstor.h (inclure Ntddstor.h)

Voir aussi

IOCTL_STORAGE_PERSISTENT_RESERVE_IN

IOCTL_STORAGE_PERSISTENT_RESERVE_OUT

Partager via