structure PERSISTENT_RESERVE_COMMAND (ntddstor.h)

Article
02/07/2025

La structure PERSISTENT_RESERVE_COMMAND est utilisée conjointement avec les demandes de IOCTL_STORAGE_PERSISTENT_RESERVE_IN et de 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 dans 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

Taille de cette structure.

DUMMYUNIONNAME

DUMMYUNIONNAME.PR_IN

DUMMYUNIONNAME.PR_IN.ServiceAction

Code d’action de service pour cette requête IOCTL_STORAGE_PERSISTENT_RESERVE_IN. PR_IN. ServiceAction peut être l’une des valeurs suivantes : RESERVATION_ACTION_READ_KEYS RESERVATION_ACTION_READ_RESERVATIONS

DUMMYUNIONNAME.PR_IN.Reserved1

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

DUMMYUNIONNAME.PR_IN.AllocationLength

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

DUMMYUNIONNAME.PR_OUT

DUMMYUNIONNAME.PR_OUT.ServiceAction

Code d’action de service pour cette requête IOCTL_STORAGE_PERSISTENT_RESERVE_OUT. PR_OUT. ServiceAction peut être 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 égal à zéro.

DUMMYUNIONNAME.PR_OUT.Type

Valeur qui spécifie les caractéristiques de la réservation persistante. PR_OUT. Le 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 de l’appareil de stockage lorsqu’une commande de réserve permanente SCSI ou une commande de réserve permanente SCSI est reçue dans la spécification SCSI Primary Commands - 2 (SPC-2).

Exigences

Exigence	Valeur
d’en-tête	ntddstor.h (include Ntddstor.h)

Voir aussi

IOCTL_STORAGE_PERSISTENT_RESERVE_IN

IOCTL_STORAGE_PERSISTENT_RESERVE_OUT

Partager via