Funzione ScsiPortFreeDeviceBase (srb.h)

  • Articolo

La routine ScsiPortFreeDeviceBase libera un intervallo di indirizzi di spazio di I/O o memoria del dispositivo mappati in precedenza nello spazio indirizzi di sistema con ScsiPortGetDeviceBase.

Nota I modelli di driver di porta SCSI e miniport SCSI potrebbero essere modificati o non disponibili in futuro. È invece consigliabile usare il driver Storport e i modelli di driver miniport Storport .
 

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 di porta alloca e inizializza per conto del driver miniport. I driver Miniport archivia in genere informazioni specifiche dell'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 membro DeviceExtension-HwDeviceExtension> dell'oggetto dispositivo 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 la routine HwScsiFindAdapter di un driver miniport determina che il driver non necessita di un indirizzo di base mappato specifico per una scheda, 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 non corretta per il chiamante.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione srb.h (include Miniport.h, Scsi.h)
Libreria Scsiport.lib

Vedi anche

HwScsiFindAdapter

ScsiPortGetDeviceBase