struttura SPB_TRANSFER_LIST (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;
Membri
Size
Dimensione, in byte, della struttura SPB_TRANSFER_LIST. Questo valore di dimensione non include alcun Trasferimenti elementi di matrice 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 utilizzata.
Reserved
Riservato per l'uso dal sistema operativo. Impostare su zero.
TransferCount
Numero di elementi nella matrice trasferimenti di. Questa matrice contiene almeno un elemento.
Transfers[1]
Questo membro è il primo elemento di una matrice di strutture SPB_TRANSFER_LIST_ENTRY. Ogni elemento della 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.
Osservazioni
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 viene specificato nel Trasferimenti membro 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 Trasferisci membro di questa struttura, contiene i dati da scrivere nel dispositivo. Il secondo buffer, descritto da un elemento di matrice 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 I/O personalizzate (IOCTL) che usano buffer di input o output, usare la struttura SPB_TRANSFER_LIST per descrivere questi buffer. Per altre informazioni, vedere Using the SPB_TRANSFER_LIST Structure for Custom IOCTLs.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Supportato a partire da Windows 8. |
| intestazione | spb.h |