Compartir a través de


Función ScsiPortFreeDeviceBase (srb.h)

La rutina ScsiPortFreeDeviceBase libera un intervalo de direcciones de espacio de memoria o E/S de dispositivo asignadas previamente al espacio de direcciones del sistema con ScsiPortGetDeviceBase.

Nota Los modelos de controlador de puerto SCSI y controlador de minipuerto SCSI pueden modificarse o no estar disponibles en el futuro. En su lugar, se recomienda usar los modelos del controlador Storport y del controlador storport miniport .
 

Sintaxis

SCSIPORT_API VOID ScsiPortFreeDeviceBase(
  [in] PVOID HwDeviceExtension,
  [in] PVOID MappedAddress
);

Parámetros

[in] HwDeviceExtension

Puntero a la extensión de dispositivo de hardware. Se trata de un área de almacenamiento por HBA que el controlador de puerto asigna e inicializa en nombre del controlador de minipuerto. Los controladores de minipuerto suelen almacenar información específica de HBA en esta extensión, como el estado del HBA y los intervalos de acceso asignados del HBA. Esta área está disponible para el controlador de minipuerto en el miembro DeviceExtension-HwDeviceExtension> del objeto de dispositivo del HBA inmediatamente después de que el controlador de miniporte llame a ScsiPortInitialize. El controlador de puerto libera esta memoria cuando quita el dispositivo.

[in] MappedAddress

Puntero a la dirección base del intervalo que se va a liberar. Esta dirección debe ser la misma que la devuelta por ScsiPortGetDeviceBase.

Valor devuelto

None

Observaciones

Si la rutina HwScsiFindAdapter de un controlador de miniporte determina que el controlador no necesita una dirección base asignada determinada para un adaptador, debe liberar la asignación llamando a esta rutina. Por ejemplo, cuando un controlador de minipuerto determina que no hay HBA admitidos en un bus de E/S determinado, debe llamar a ScsiPortFreeDeviceBase con cada dirección asignada devuelta por ScsiPortGetDeviceBase, si se realizaron llamadas a esta rutina.

Solo se puede llamar a ScsiPortFreeDeviceBase desde la rutina HwScsiFindAdapter del controlador de miniport. Las llamadas de otras rutinas del controlador de miniportar provocarán un error del sistema o una operación incorrecta para el autor de la llamada.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado srb.h (incluye Miniport.h, Scsi.h)
Library Scsiport.lib

Consulte también

HwScsiFindAdapter

ScsiPortGetDeviceBase