Funzione ScsiPortFreeDeviceBase (srb.h)
La routine ScsiPortFreeDeviceBase libera un intervallo di indirizzi di spazio di I/O o memoria del dispositivo mappati in precedenza nello spazio degli indirizzi di sistema con ScsiPortGetDeviceBase.
Sintassi
SCSIPORT_API VOID ScsiPortFreeDeviceBase(
[in] PVOID HwDeviceExtension,
[in] PVOID MappedAddress
);
Parametri
[in] HwDeviceExtension
Puntatore all'estensione del dispositivo hardware. Si tratta di un'area di archiviazione per HBA che il driver della porta alloca e inizializza per conto del driver miniport. I driver Miniport in genere archiviano informazioni specifiche di HBA in questa estensione, ad esempio lo stato dell'HBA e gli intervalli di accesso mappati dell'HBA. Questa area è disponibile per il driver miniport nel DeviceExtension->HwDeviceExtension membro dell'oggetto dispositivo dell'HBA subito dopo che il driver miniport chiama ScsiPortInitialize. Il driver della porta libera questa memoria quando rimuove il dispositivo.
[in] MappedAddress
Puntatore all'indirizzo di base dell'intervallo da liberare. Questo indirizzo deve essere uguale a quello restituito da ScsiPortGetDeviceBase.
Valore restituito
Nessuno
Osservazioni
Se un driver miniport routine HwScsiFindAdapter determina che il driver non necessita di un indirizzo di base mappato specifico per un adattatore, deve rilasciare il mapping chiamando questa routine. Ad esempio, quando un driver miniport determina che non sono presenti HBA supportati in un determinato bus di I/O, deve chiamare ScsiPortFreeDeviceBase con ogni indirizzo mappato restituito da ScsiPortGetDeviceBase, se sono state effettuate chiamate a questa routine.
ScsiPortFreeDeviceBase può essere chiamato solo dalla routine HwScsiFindAdapter del driver miniport. Le chiamate da altre routine del driver miniport genereranno un errore di sistema o un'operazione errata per il chiamante.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | srb.h (include Miniport.h, Scsi.h) |
| libreria | Scsiport.lib |