estrutura SPB_TRANSFER_LIST (spb.h)
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 Transfers elementos de matriz que possam 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. Definido como zero.
TransferCount
O número de elementos na matriz transferências. 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.
Observações
O buffer de entrada de uma solicitação de IOCTL_SPB_EXECUTE_SEQUENCE começa com uma estrutura de SPB_TRANSFER_LIST. A primeira transferência na sequência de transferência de E/S solicitada é especificada no Transfers membro dessa estrutura. Se a sequência contiver mais de uma transferência, os elementos da matriz que descrevem as transferências adicionais seguirão imediatamente a estrutura SPB_TRANSFER_LIST.
O buffer de entrada de uma solicitação IOCTL_SPB_FULL_DUPLEX começa com uma estrutura SPB_TRANSFER_LIST. A estrutura SPB_TRANSFER_LIST para essa solicitação sempre especifica dois buffers. O primeiro buffer, descrito pelo Transfers membro 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 de SPB_TRANSFER_LIST, é usado para manter os dados lidos do dispositivo.
Se o driver do controlador SPB der suporte a solicitações personalizadas de controle de E/S (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 |
|---|---|
| de cliente com suporte mínimo | Com suporte a partir do Windows 8. |
| cabeçalho | spb.h |