SPB_TRANSFER_LIST struttura (spb.h)
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 |