SPB_TRANSFER_LIST struttura (spb.h)

  • Articolo

La struttura SPB_TRANSFER_LIST descrive una sequenza di trasferimento di I/O.

Sintassi

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

Members

Size

Dimensioni, in byte, della struttura SPB_TRANSFER_LIST . Questo valore di dimensione non include elementi della matrice Transfer che potrebbero seguire questa struttura. Se i nuovi membri vengono aggiunti alle versioni future di questa struttura, è possibile utilizzare il valore Size per determinare quale versione della struttura SPB_TRANSFER_LIST viene usata.

Reserved

Riservato per l'uso dal sistema operativo. Imposta su zero.

TransferCount

Numero di elementi nella matrice Trasferisci . Questa matrice contiene un minimo di un elemento.

Transfers[1]

Questo membro è il primo elemento in una matrice di strutture SPB_TRANSFER_LIST_ENTRY . Ogni elemento matrice descrive un singolo trasferimento nella sequenza di trasferimento di I/O. Se la matrice contiene più di un elemento, gli elementi della matrice aggiuntivi seguono immediatamente la struttura SPB_TRANSFER_LIST in memoria. I trasferimenti vengono eseguiti nell'ordine in cui vengono visualizzati nella matrice, a partire dal primo elemento.

Commenti

Il buffer di input per una richiesta di IOCTL_SPB_EXECUTE_SEQUENCE inizia con una struttura SPB_TRANSFER_LIST . Il primo trasferimento nella sequenza di trasferimento di I/O richiesto è specificato nel membro Trasferisci di questa struttura. Se la sequenza contiene più di un trasferimento, gli elementi della matrice che descrivono i trasferimenti aggiuntivi seguono immediatamente la struttura SPB_TRANSFER_LIST .

Il buffer di input per una richiesta di IOCTL_SPB_FULL_DUPLEX inizia con una struttura SPB_TRANSFER_LIST . La struttura SPB_TRANSFER_LIST per questa richiesta specifica sempre due buffer. Il primo buffer, descritto dal membro Trasferisci di questa struttura, contiene i dati da scrivere nel dispositivo. Il secondo buffer, descritto da un elemento array che segue immediatamente la struttura SPB_TRANSFER_LIST , viene usato per contenere i dati letti dal dispositivo.

Se il driver del controller SPB supporta richieste di I/O personalizzate che usano buffer di input o output, usare la struttura di SPB_TRANSFER_LIST per descrivere questi buffer. Per altre informazioni, vedere Uso della struttura SPB_TRANSFER_LIST per IOCTLs personalizzati.

Requisiti

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

Vedi anche