estrutura TAPE_SET_POSITION (winnt.h)

  • Artigo

A estrutura TAPE_SET_POSITION descreve como e onde posicionar a fita.

Sintaxe

typedef struct _TAPE_SET_POSITION {
  DWORD         Method;
  DWORD         Partition;
  LARGE_INTEGER Offset;
  BOOLEAN       Immediate;
} TAPE_SET_POSITION, *PTAPE_SET_POSITION;

Membros

Method

Tipo de posicionamento. Esse membro deve ser um dos valores a seguir.

Valor Significado
TAPE_ABSOLUTE_BLOCK
1L
 Move a fita para o endereço de bloco específico do dispositivo especificado pelo membro Offset . O membro partition é ignorado.
TAPE_LOGICAL_BLOCK
2L
 Move a fita para o endereço de bloco especificado por Offset na partição especificada pela Partição.
TAPE_REWIND
0L
 Move a fita para o início da partição atual. Os membros Partição e Deslocamento são ignorados.
TAPE_SPACE_END_OF_DATA
4L
 Move a fita para o final dos dados na partição especificada pela Partição.
TAPE_SPACE_FILEMARKS
6L
 Move a fita para frente (ou para trás) o número de marcas de arquivo especificadas por Offset na partição atual. O membro partition é ignorado.
TAPE_SPACE_RELATIVE_BLOCKS
5L
 Move a fita para frente (ou para trás) o número de blocos especificado por Offset na partição atual. O membro partition é ignorado.
TAPE_SPACE_SEQUENTIAL_FMKS
7L
 Move a fita para frente (ou para trás) para a primeira ocorrência de n marcas de arquivo na partição atual, em que n é o número especificado por Offset. O parâmetro Partition é ignorado.
TAPE_SPACE_SEQUENTIAL_SMKS
9L
 Move a fita para frente (ou para trás) para a primeira ocorrência de n setmarks na partição atual, em que n é o número especificado por Offset. O membro partition é ignorado.
TAPE_SPACE_SETMARKS
8L
 Move a fita para frente (ou para trás) o número de setmarks especificado por Offset na partição atual. O membro partition é ignorado.

Partition

Partição na qual posicionar. Se esse membro for zero, a partição atual será assumida.

Offset

Bloquear endereço ou contagem para a operação de posição especificada pelo membro method .

Immediate

Se esse membro for TRUE, retorne assim que a operação começar. Caso contrário, retorne após a conclusão da operação.

Comentários

Se o posicionamento for relativo, um deslocamento positivo moverá a fita para frente (no final da fita) e um deslocamento negativo moverá a fita para trás (em direção ao início da fita).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho winnt.h (inclua Windows.h)