RECEIVE_TOKEN_INFORMATION_HEADER-Struktur (minitape.h)
Die RECEIVE_TOKEN_INFORMATION_HEADER-Struktur enthält Informationen, die als status aus einem Auslagerungsvorgang für die Datenübertragung zurückgegeben werden.
Syntax
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;
Member
AvailableData[4]
Die im SenseData-Array verfügbare Datenmenge und alle zusätzlichen Ergebnisinformationen.
ResponseToServiceAction
Ein Antwortcode, der angibt, für welche Befehlsaktion die Antwort gilt. Die Dienstaktionscodes sind wie folgt:
| Wert | Bedeutung |
|---|---|
| SERVICE_ACTION_POPULATE_TOKEN | Die Antwortinformationen sind für einen POPULATE TOKEN-Befehl. |
| SERVICE_ACTION_WRITE_USING_TOKEN | Die Antwortinformationen sind für den Befehl WRITE USING TOKEN vorgesehen. |
Reserved1
Reserviert.
OperationStatus
Die aktuelle status des Kopiervorgangs. Der status kann einer der folgenden Werte sein.
| Wert | Bedeutung |
|---|---|
| 0x01 | Der Vorgang wurde erfolgreich abgeschlossen. |
| 0x02 | Der Vorgang wurde nicht erfolgreich abgeschlossen. |
| 0x04 | Der Vorgang wurde erfolgreich abgeschlossen, aber der Kopierinitiator sollte überprüfen, ob alle Daten übertragen wurden. |
| 0x10 | Der Vorgang wird ausgeführt. Der Vordergrund- oder Hintergrundvorgangsstatus ist unbekannt. |
| 0x11 | Der Vorgang wird im Vordergrund ausgeführt. |
| 0x12 | Der Vorgang wird im Hintergrund ausgeführt. |
| 0x60 | Der Vorgang wurde beendet. Möglicherweise durch eine vorhandene Ressourcenreservierung. |
Reserved2
Reserviert.
OperationCounter[2]
Die Anzahl der Befehle, die für den aktuellen Kopiervorgang verarbeitet werden.
EstimatedStatusUpdateDelay[4]
Die empfohlene Zeit in Millisekunden, um auf aktualisierte Informationen zum aktuellen Kopiervorgang zu warten, bevor der nächste RECEIVE COPY STATUS-Befehl gesendet wird.
CompletionStatus
SCSI-status Code für den Kopierbefehlsvorgang.
SenseDataFieldLength
Die Länge des gesamten Datenbereichs in Bytes, der für Sense-Daten verfügbar ist. Dieser Wert ist immer >= SenseDataLength.
SenseDataLength
Die Länge der Daten in SenseData in Bytes.
TransferCountUnits
Die auf TransferCount angewendeten Byteeinheiten. Jede Einheitenerweiterung ist ein Exponent in Basis 2. Der Multiplikatorwert von TRANSFER_COUNT_UNITS_KIBIBYTES ist beispielsweise 1024 und nicht 1000. Die definierten Einheiten sind die folgenden.
| Wert | Bedeutung |
|---|---|
| TRANSFER_COUNT_UNITS_BYTES | Die Anzahl der Übertragungen ist in Bytes. |
| TRANSFER_COUNT_UNITS_KIBIBYTES | Die Übertragungsanzahl liegt in Kilobytes. |
| TRANSFER_COUNT_UNITS_MEBIBYTES | Die Anzahl der Übertragungen liegt in Megabytes. |
| TRANSFER_COUNT_UNITS_GIBIBYTES | Die Übertragungsanzahl liegt in Gigabyte. |
| TRANSFER_COUNT_UNITS_TEBIBYTES | Die Übertragungsanzahl liegt in Terabyte. |
| TRANSFER_COUNT_UNITS_PEBIBYTES | Die Anzahl der Übertragungen ist in Petabytes angegeben. |
| TRANSFER_COUNT_UNITS_EXBIBYTES | Die Anzahl der Übertragungen liegt in Exabytes. |
| TRANSFER_COUNT_UNITS_NUMBER_BLOCKS | Die Übertragungsanzahl ist kein Exponent, sondern in Einheiten logischer Blocklänge. |
TransferCount[8]
Die Länge der übertragenen Daten im Vorgang. Der Einheitentyp in TransferCountUnits wird auf diesen Wert angewendet, um die Gesamtbyteanzahl zu erhalten.
SegmentsProcessed[2]
Die Anzahl der Segmente, die für den Datenübertragungsvorgang verarbeitet werden. Segmente sind Einheiten der Kopierlänge, die intern vom Kopieranbieter eines Speichergeräts verwendet werden. Auf Windows-Systemen ist dieser Wert reserviert, und Anwendungen müssen diesen Member ignorieren.
Reserved3[6]
Reserviert.
SenseData[ANYSIZE_ARRAY]
Sense-Daten, die für den Kopiervorgang zurückgegeben werden.
Hinweise
Wenn RECEIVE_TOKEN_INFORMATION_HEADER für einen POPULATE TOKEN-Befehlsvorgang gilt und der Befehl erfolgreich abgeschlossen wurde, ist auch eine RECEIVE_TOKEN_INFORMATION_RESPONSE_HEADER-Struktur nach SenseData in einem Offset von SenseDataFieldLength vom Anfang des SenseData-Arrays vorhanden. Die RECEIVE_TOKEN_INFORMATION_RESPONSE_HEADER-Struktur enthält das Token, das als Darstellung von Daten (ROD) für die mit dem Befehl gesendeten Bereichsparameter erstellt wurde.
Alle Multibytewerte haben das Big-Endian-Format. Vor der Auswertung müssen diese Werte so konvertiert werden, dass sie dem Endian-Format der aktuellen Plattform entsprechen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8. |
| Kopfzeile | minitape.h (include Scsi.h, Minitape.h, Storport.h) |