TAPE_SET_POSITION 구조체(ntddtape.h)

아티클
02/29/2024

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

오프셋으로 지정된 시작부터 오프셋에 있는 절대 블록 주소에 테이프를 배치합니다. Partition 멤버의 값은 무시됩니다.

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

현재 위치에서 시작하여 오프셋에 지정된 연속된 setmark 수의 다음 발생(있는 경우) 바로 다음에 테이프를 배치합니다. 파티션 멤버는 무시됩니다.

Partition

테이프의 위치를 설정할 파티션을 나타냅니다. 이 멤버에는 다음 값 중 하나가 있어야 합니다.

NOT_PARTITIONED(또는 0)
DATA_PARTITION
DIRECTORY_PARTITION

미디어가 분할되지 않은 경우 이 멤버는 0입니다.

Offset

메서드의 값에 따라 형식이 달라지는 오프셋을 지정합니다. 지정한 메서드가 테이프를 블록 주소에 배치하는 경우 Offset 은 지정된 파티션에 대한 바이트 오프셋을 지정합니다. 지정된 메서드가 블록, 파일 표시 또는 setmarks를 건너뛰는 경우 Offset 은 건너뛸 숫자를 지정합니다. Offset이 0이면 테이프가 파티션의 시작 부분에 배치됩니다.

Immediate

TRUE로 설정하면 대상 디바이스가 즉시 상태 반환해야 했음을 나타냅니다. FALSE로 설정하면 작업이 완료된 후 디바이스가 상태 반환해야 했음을 나타냅니다.

설명

드라이브 또는 테이프가 모든 메서드 값을 지원하지 않을 수 있습니다.

파티션은 논리적으로 1에서 N으로 번호가 매겨집니다. 그러나 파티션 번호는 테이프의 물리적 위치를 의미하지는 않습니다. 예를 들어 파티션 번호 1은 미디어의 시작 부분에 없을 수 있습니다.

오프셋이 배치할 블록, 파일마크 또는 setmark의 수를 지정하는 경우 오프셋의 양수 값 N은 N 블록, 파일 표시 또는 setmark 위에 정방향 위치를 지정하여 블록, 파일 표시 또는 setmark의 파티션 끝 또는 테이프 끝 쪽에서 중지됩니다. 오프셋의 값이 0이면 위치가 변경되지 않습니다. 오프셋의 음수 값 N은 파티션 또는 테이프 미디어의 시작 부분과 N개 블록, 파일 표시 또는 setmark를 통해 역방향 위치 지정을 발생시키고 블록, 파일 표시 또는 setmark의 파티션 시작 쪽에서 중지됩니다.

요구 사항

요구 사항	값
헤더	ntddtape.h(Ntddtape.h, Minitape.h 포함)

추가 정보

IOCTL_TAPE_SET_POSITION

TapeMiniSetPosition

다음을 통해 공유