estrutura SPB_TRANSFER_LIST (spb.h)

  • Artigo

A estrutura SPB_TRANSFER_LIST descreve uma sequência de transferência de E/S.

Sintaxe

typedef struct SPB_TRANSFER_LIST {
  ULONG                   Size;
  ULONG                   Reserved;
  ULONG                   TransferCount;
  SPB_TRANSFER_LIST_ENTRY Transfers[1];
} SPB_TRANSFER_LIST, *PSPB_TRANSFER_LIST;

Membros

Size

O tamanho, em bytes, da estrutura SPB_TRANSFER_LIST . Esse valor de tamanho não inclui nenhum elemento de matriz Transfers que possa seguir essa estrutura. Se novos membros forem adicionados a versões futuras dessa estrutura, o valor Size poderá ser usado para determinar qual versão da estrutura SPB_TRANSFER_LIST está sendo usada.

Reserved

Reservado para uso pelo sistema operacional. Defina como zero.

TransferCount

O número de elementos na matriz Transfers . Essa matriz contém um mínimo de um elemento.

Transfers[1]

Esse membro é o primeiro elemento em uma matriz de estruturas de SPB_TRANSFER_LIST_ENTRY . Cada elemento de matriz descreve uma transferência individual na sequência de transferência de E/S. Se a matriz contiver mais de um elemento, os elementos de matriz adicionais seguirão imediatamente a estrutura SPB_TRANSFER_LIST na memória. As transferências são executadas na ordem em que aparecem na matriz, começando com o primeiro elemento.

Comentários

O buffer de entrada de uma solicitação de IOCTL_SPB_EXECUTE_SEQUENCE começa com uma estrutura SPB_TRANSFER_LIST . A primeira transferência na sequência de transferência de E/S solicitada é especificada no membro Transfers dessa estrutura. Se a sequência contiver mais de uma transferência, os elementos de matriz que descrevem as transferências adicionais seguirão imediatamente a estrutura SPB_TRANSFER_LIST .

O buffer de entrada de uma solicitação de IOCTL_SPB_FULL_DUPLEX começa com uma estrutura SPB_TRANSFER_LIST . A estrutura de SPB_TRANSFER_LIST para essa solicitação sempre especifica dois buffers. O primeiro buffer, que é descrito pelo membro Transfers dessa estrutura, contém os dados a serem gravados no dispositivo. O segundo buffer, que é descrito por um elemento de matriz que segue imediatamente a estrutura SPB_TRANSFER_LIST , é usado para manter os dados lidos do dispositivo.

Se o driver do controlador SPB der suporte a solicitações de controle de E/S personalizadas (IOCTL) que usam buffers de entrada ou saída, use a estrutura SPB_TRANSFER_LIST para descrever esses buffers. Para obter mais informações, consulte Usando a estrutura de SPB_TRANSFER_LIST para IOCTLs personalizados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte começando com Windows 8.
Cabeçalho spb.h

Confira também