TAPE_SET_POSITION 구조체(minitape.h)
TAPE_SET_POSITION 구조체는 IOCTL_TAPE_SET_POSITION 요청과 함께 테이프의 현재 위치를 지정된 파티션 및 오프셋으로 이동하는 데 사용됩니다.
구문
typedef struct _TAPE_SET_POSITION {
ULONG Method;
ULONG Partition;
LARGE_INTEGER Offset;
BOOLEAN Immediate;
} TAPE_SET_POSITION, *PTAPE_SET_POSITION;
멤버
Method
수행할 위치 유형을 나타냅니다. 이 멤버에는 다음 값 중 하나가 있어야 합니다.
TAPE_REWIND
미디어가 분할된 경우 파티션 에 표시된 파티션의 시작 부분에 테이프를 배치하고 미디어가 분할되지 않은 경우 미디어 시작 부분에 배치합니다. 미디어가 분할되지 않은 경우 파티션 을 0으로 설정해야 합니다. Offset 멤버는 무시됩니다.
TAPE_ABSOLUTE_BLOCK
오프셋으로 지정된 시작부터 오프셋에 있는 절대 블록 주소에 테이프를 배치합니다. 파티션 멤버의 값은 무시됩니다.
TAPE_LOGICAL_BLOCK
파티션에 표시된 파티션의 시작을 기준으로 오프셋으로 지정된 논리 블록 주소에 테이프를 배치합니다. 미디어가 분할되지 않은 경우 파티션 을 0으로 설정해야 합니다.
TAPE_PSEUDO_LOGICAL_BLOCK
파티션에 표시된 파티션의 시작을 기준으로 오프셋으로 지정된 pseudological 블록 주소에 테이프를 배치합니다. 미디어가 분할되지 않은 경우 파티션 은 0이어야 합니다.
TAPE_SPACE_END_OF_DATA
파티션에 표시된 파티 션의 끝에 테이프를 배치하거나 미디어가 분할되지 않은 경우 테이프의 끝에 배치합니다. Offset 멤버는 무시됩니다.
TAPE_SPACE_RELATIVE_BLOCKS
현재 위치에서 시작하여 오프셋으로 지정된 블록 수 바로 다음에 테이프를 배치합니다. 파티션 멤버는 무시됩니다.
TAPE_SPACE_FILEMARKS
현재 위치에서 시작하여 오프셋으로 지정된 파일 표시 수 바로 다음에 테이프를 배치합니다. 파티션 멤버는 무시됩니다.
TAPE_SPACE_SEQUENTIAL_FMKS
현재 위치에서 시작하여 오프셋으로 지정된 연속 파일 표시 수의 다음 발생(있는 경우) 바로 다음에 테이프를 배치합니다. 파티션 멤버는 무시됩니다.
TAPE_SPACE_SETMARKS
현재 위치에서 시작하여 오프셋으로 지정된 setmark 수 바로 다음에 테이프를 배치합니다. 파티션 멤버는 무시됩니다.
TAPE_SPACE_SEQUENTIAL_SMKS
현재 위치에서 시작하여 오프셋으로 지정된 연속 집합 표시 수의 다음 발생(있는 경우) 바로 다음에 테이프를 배치합니다. 파티션 멤버는 무시됩니다.
Partition
테이프의 위치를 설정할 파티션을 나타냅니다. 이 멤버에는 다음 값 중 하나가 있어야 합니다.
- NOT_PARTITIONED(또는 0)
- DATA_PARTITION
- DIRECTORY_PARTITION
미디어가 분할되지 않은 경우 이 멤버는 0입니다.
Offset
형식이 메서드의 값에 따라 달라지는 오프셋을 지정합니다. 지정한 메서드가 테이프를 블록 주소에 배치하는 경우 Offset 은 지정된 파티션에 바이트 오프셋을 지정합니다. 지정한 메서드가 블록, 파일 표시 또는 setmarks를 건너뛰는 경우 Offset 은 건너뛸 숫자를 지정합니다. Offset이 0이면 테이프가 파티션의 시작 부분에 배치됩니다.
Immediate
TRUE로 설정하면 대상 디바이스가 즉시 상태 반환해야 했음을 나타냅니다. FALSE로 설정하면 작업이 완료된 후 디바이스가 상태 반환해야 했음을 나타냅니다.
설명
드라이브 또는 테이프가 모든 메서드 값을 지원하지 않을 수 있습니다.
파티션은 논리적으로 1에서 N으로 번호가 매겨집니다. 그러나 파티션 번호는 테이프의 물리적 위치를 의미하지는 않습니다. 예를 들어 파티션 번호 1은 미디어 시작 부분에 없을 수 있습니다.
오프셋이 여러 블록, 파일 표시 또는 위에 배치할 setmarks를 지정하는 경우 오프셋의 양수 값 N은 N 블록, 파일 표시 또는 setmark 위에 정방향 위치를 지정하여 블록, 파일 표시 또는 setmark의 파티션 끝 또는 테이프 끝 쪽에서 중지됩니다. 오프셋의 값이 0이면 위치가 변경되지 않습니다. 오프셋의 음수 값 N은 파티션 또는 테이프 미디어의 시작 부분에서 N 블록, 파일 표시 또는 setmark를 통해 역방향 위치를 지정하여 블록, 파일 표시 또는 setmark의 파티션 시작 쪽에서 중지됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | minitape.h(Ntddtape.h, Minitape.h 포함) |