Funzione StorPortGetScatterGatherList (storport.h)
La routine StorPortGetScatterGatherList recupera l'elenco a dispersione/raccolta associato per il blocco di richieste SCSI (SRB) specificato.
Sintassi
STORPORT_API PSTOR_SCATTER_GATHER_LIST StorPortGetScatterGatherList(
[in] PVOID HwDeviceExtension,
[in] PSCSI_REQUEST_BLOCK Srb
);
Parametri
[in] HwDeviceExtension
Puntatore all'estensione del dispositivo hardware. Si tratta di un'area di archiviazione per hba che il driver di porta alloca e inizializza per conto del driver miniport. I driver Miniport archivia in genere informazioni specifiche di HBA in questa estensione, ad esempio lo stato dell'HBA e gli intervalli di accesso mappati per l'HBA. Questa area è disponibile per il miniport subito dopo che il driver miniport chiama StorPortInitialize. Il driver della porta libera questa memoria quando rimuove il dispositivo.
[in] Srb
Puntatore a SRB per il quale deve essere costruito l'elenco di raccolta a dispersione.
Valore restituito
StorPortGetScatterGatherList restituisce un puntatore all'elenco a dispersione/raccolta.
Osservazioni
Questa routine viene fornita con la libreria di driver Storport. Non è disponibile alcuna routine parallela nella libreria di porte SCSI.
Il puntatore all'elenco a dispersione/raccolta restituito è valido solo fino al completamento di SRB.
Il driver miniport non deve liberare la memoria per l'elenco a dispersione/raccolta che StorPortGetScatterGatherList restituisce.
Il driver miniport non deve modificare l'elenco a dispersione/raccolta.
A partire da Windows 8, il parametro Srb può puntare a SCSI_REQUEST_BLOCK o STORAGE_REQUEST_BLOCK. Se l'identificatore della funzione nel campo funzione di Srb è SRB_FUNCTION_STORAGE_REQUEST_BLOCK, la funzione SRB è una struttura di richiesta STORAGE_REQUEST_BLOCK.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | storport.h (include Storport.h) |
| libreria | Storport.lib |