structure RECEIVE_TOKEN_INFORMATION_HEADER (minitape.h)
La structure RECEIVE_TOKEN_INFORMATION_HEADER contient des informations retournées en tant qu’état à partir d’une opération de transfert de données de déchargement.
Syntaxe
typedef struct {
UCHAR AvailableData[4];
UCHAR ResponseToServiceAction : 5;
UCHAR Reserved1 : 3;
UCHAR OperationStatus : 7;
UCHAR Reserved2 : 1;
UCHAR OperationCounter[2];
UCHAR EstimatedStatusUpdateDelay[4];
UCHAR CompletionStatus;
UCHAR SenseDataFieldLength;
UCHAR SenseDataLength;
UCHAR TransferCountUnits;
UCHAR TransferCount[8];
UCHAR SegmentsProcessed[2];
UCHAR Reserved3[6];
UCHAR SenseData[ANYSIZE_ARRAY];
} RECEIVE_TOKEN_INFORMATION_HEADER, *PRECEIVE_TOKEN_INFORMATION_HEADER;
Membres
AvailableData[4]
Quantité de données disponibles dans le tableau SenseData et toutes les informations de résultat supplémentaires.
ResponseToServiceAction
Code de réponse indiquant l’action de commande pour laquelle la réponse est activée. Les codes d’action de service sont les suivants.
| Valeur | Signification |
|---|---|
| SERVICE_ACTION_POPULATE_TOKEN | Les informations de réponse concernent une commande POPULATE TOKEN. |
| SERVICE_ACTION_WRITE_USING_TOKEN | Les informations de réponse concernent une commande WRITE USING TOKEN. |
Reserved1
Réservé.
OperationStatus
État actuel de l’opération de copie. L’état peut être l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
| 0x01 | L’opération s’est terminée avec succès. |
| 0x02 | L’opération s’est terminée sans succès. |
| 0x04 | L’opération s’est terminée correctement, mais l’initiateur de copie doit vérifier que toutes les données ont été transférées. |
| 0x10 | L’opération est en cours. L’état de l’opération de premier plan ou d’arrière-plan est inconnu. |
| 0x11 | L’opération est en cours au premier plan. |
| 0x12 | L’opération est en cours en arrière-plan. |
| 0x60 | L’opération a été arrêtée. Éventuellement par une réservation de ressources existante. |
Reserved2
Réservé.
OperationCounter[2]
Nombre de commandes traitées pour l’opération de copie actuelle.
EstimatedStatusUpdateDelay[4]
Temps recommandé, en millisecondes, d’attendre avant d’envoyer la commande RECEIVE COPY STATUS suivante pour obtenir des informations mises à jour sur l’opération de copie actuelle.
CompletionStatus
Code d’état SCSI pour l’opération de commande de copie.
SenseDataFieldLength
Longueur, en octets, de l’ensemble de la zone de données disponible pour les données de sens. Cette valeur est toujours >= SenseDataLength.
SenseDataLength
Longueur, en octets, des données dans SenseData.
TransferCountUnits
Unités d’octet appliquées à TransferCount. Chaque extension d’unité est un exposant en base 2. La valeur multiplicateur de TRANSFER_COUNT_UNITS_KIBIBYTES, par exemple, est 1024 et non 1 000. Les unités définies sont les suivantes.
| Valeur | Signification |
|---|---|
| TRANSFER_COUNT_UNITS_BYTES | Le nombre de transferts est en octets. |
| TRANSFER_COUNT_UNITS_KIBIBYTES | Le nombre de transferts est en kilo-octets. |
| TRANSFER_COUNT_UNITS_MEBIBYTES | Le nombre de transferts est en mégaoctets. |
| TRANSFER_COUNT_UNITS_GIBIBYTES | Le nombre de transferts est en gigaoctets. |
| TRANSFER_COUNT_UNITS_TEBIBYTES | Le nombre de transferts est en téraoctets. |
| TRANSFER_COUNT_UNITS_PEBIBYTES | Le nombre de transferts est en pétaoctets. |
| TRANSFER_COUNT_UNITS_EXBIBYTES | Le nombre de transferts est en exaoctets. |
| TRANSFER_COUNT_UNITS_NUMBER_BLOCKS | Le nombre de transferts n’est pas un exposant, mais en unités de longueur de bloc logique. |
TransferCount[8]
Longueur des données transférées dans l’opération. Le type d’unité dans TransferCountUnits est appliqué à cette valeur pour donner le nombre total d’octets.
SegmentsProcessed[2]
Nombre de segments traités pour l’opération de transfert de données. Les segments sont des unités de longueur de copie utilisées en interne par le fournisseur de copie d’un appareil de stockage. Sur les systèmes Windows, cette valeur est réservée et les applications doivent ignorer ce membre.
Reserved3[6]
Réservé.
SenseData[ANYSIZE_ARRAY]
Sens les données retournées pour l’opération de copie.
Remarques
Si RECEIVE_TOKEN_INFORMATION_HEADER concerne une opération de commande POPULATE TOKEN et que la commande s’est terminée correctement, une structure de RECEIVE_TOKEN_INFORMATION_RESPONSE_HEADER est également présente après SenseData à un décalage de SenseDataFieldLength à partir du début du tableau SenseData. La structure RECEIVE_TOKEN_INFORMATION_RESPONSE_HEADER contient le jeton créé en tant que représentation de données (ROD) pour les paramètres de plage envoyés avec la commande.
Toutes les valeurs multioctets sont au format big endian. Avant l’évaluation, ces valeurs doivent être converties pour correspondre au format endian de la plateforme actuelle.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8. |
| d’en-tête | minitape.h (include Scsi.h, Minitape.h, Storport.h) |