estrutura SPB_TRANSFER_BUFFER (spb.h)

  • Artigo

A estrutura SPB_TRANSFER_BUFFER descreve o buffer de dados para uma transferência individual em uma sequência de transferência de E/S.

Sintaxe

typedef struct SPB_TRANSFER_BUFFER {
  SPB_TRANSFER_BUFFER_FORMAT Format;
  union {
    SPB_TRANSFER_BUFFER_LIST_ENTRY Simple;
    struct {
      PSPB_TRANSFER_BUFFER_LIST_ENTRY List;
      ULONG                           ListCe;
    } BufferList;
    PMDL                           Mdl;
  };
} SPB_TRANSFER_BUFFER, *PSPB_TRANSFER_BUFFER;

Membros

Format

O formato do buffer. Esse membro é definido como um dos seguintes valores de enumeração SPB_TRANSFER_BUFFER_FORMAT :

  • SpbTransferBufferFormatSimple
  • SpbTransferBufferFormatList
  • SpbTransferBufferFormatSimpleNonPaged
  • SpbTransferBufferFormatMdl

SpbTransferBufferFormatMdl é um valor válido apenas para sequências de transferência de E/S solicitadas por clientes do driver do controlador SPB que são componentes do modo kernel.

Simple

Uma estrutura SPB_TRANSFER_BUFFER_LIST_ENTRY que especifica o endereço base e o comprimento de um buffer de transferência simples. Use esse membro da união se Format for SpbTransferBufferFormatSimple ou SpbTransferBufferFormatSimpleNonPaged. O formato SpbTransferBufferFormatSimpleNonPaged é usado apenas por clientes no modo kernel.

BufferList

Uma lista de coleta de dispersão que consiste em uma matriz de descritores de buffer. Use esse membro da união se Format for SpbTransferBufferFormatList.

BufferList.List

Um ponteiro para uma matriz de estruturas SPB_TRANSFER_BUFFER_LIST_ENTRY que descrevem os buffers na lista de coleta de dispersão.

BufferList.ListCe

O número de elementos na matriz List .

Mdl

Um ponteiro para um MDL que descreve o buffer. Esse membro é usado apenas por clientes do modo kernel. Use esse membro da união se Format for SpbTransferBufferFormatMdl. Para obter mais informações, consulte Comentários.

Comentários

Essa estrutura é usada por uma estrutura SPB_TRANSFER_LIST_ENTRY para descrever um buffer de transferência.

O membro MdL dessa estrutura só pode ser usado por clientes do driver do controlador SPB que são componentes do modo kernel. Os clientes do modo de usuário não devem usar esse membro. Para obter mais informações sobre MDLs, consulte Usando MDLs.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte a partir do Windows 8.
Cabeçalho spb.h

Confira também