Share via


struttura SPB_TRANSFER_BUFFER (spb.h)

La struttura SPB_TRANSFER_BUFFER descrive il buffer dei dati per un singolo trasferimento in una sequenza di trasferimento di I/O.

Sintassi

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;

Members

Format

Formato del buffer. Questo membro è impostato su uno dei valori di enumerazione SPB_TRANSFER_BUFFER_FORMAT seguenti:

  • SpbTransferBufferFormatSimple
  • SpbTransferBufferFormatList
  • SpbTransferBufferFormatSimpleNonPaged
  • SpbTransferBufferFormatMdl

SpbTransferBufferFormatMdl è un valore valido solo per le sequenze di trasferimento di I/O richieste dai client del driver del controller SPB che sono componenti in modalità kernel.

Simple

Struttura SPB_TRANSFER_BUFFER_LIST_ENTRY che specifica l'indirizzo di base e la lunghezza di un buffer di trasferimento semplice. Utilizzare questo membro dell'unione se Format è SpbTransferBufferFormatSimple o SpbTransferBufferFormatSimpleNonPaged. Il formato SpbTransferBufferFormatSimpleNonPaged viene usato solo dai client in modalità kernel.

BufferList

Elenco di raccolta a dispersione costituito da una matrice di descrittori di buffer. Utilizzare questo membro dell'unione se Format è SpbTransferBufferFormatList.

BufferList.List

Puntatore a una matrice di strutture SPB_TRANSFER_BUFFER_LIST_ENTRY che descrivono i buffer nell'elenco di raccolta a dispersione.

BufferList.ListCe

Numero di elementi nella matrice List .

Mdl

Puntatore a un MDL che descrive il buffer. Questo membro viene usato solo dai client in modalità kernel. Utilizzare questo membro dell'unione se Format è SpbTransferBufferFormatMdl. Per altre informazioni, vedere la sezione Osservazioni.

Commenti

Questa struttura viene utilizzata da una struttura SPB_TRANSFER_LIST_ENTRY per descrivere un buffer di trasferimento.

Il membro Mdl di questa struttura può essere usato solo dai client del driver controller SPB che sono componenti in modalità kernel. I client in modalità utente non devono usare questo membro. Per altre informazioni sugli mdls, vedere Using MDLs.For more information about MDLs, see Using MDLs.

Requisiti

Requisito Valore
Client minimo supportato Supportato a partire da Windows 8.
Intestazione spb.h

Vedi anche