Condividi tramite


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;

Membri

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 SpbTransferBufferFormatSimfferFormatSimpleNonPaged 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 Osservazioni.

Osservazioni

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

Il Mdl membro di questa struttura può essere usato solo dai client del driver del 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.

Fabbisogno

Requisito Valore
client minimo supportato Supportato a partire da Windows 8.
intestazione spb.h

Vedere anche