Función ScsiPortFreeDeviceBase (srb.h)

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

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

 

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 miniport. Los controladores de miniportar 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 miniport en el DeviceExtension->HwDeviceExtension miembro 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

Ninguno

Observaciones

Si una rutina de HwScsiFindAdapt er 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 miniporte 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.

ScsiPortFreeDeviceBase solo se puede llamar desde la rutina de 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	Valor
de la plataforma de destino de	Escritorio
encabezado de	srb.h (include Miniport.h, Scsi.h)
biblioteca de	Scsiport.lib

Consulte también

HwScsiFindAdapter

ScsiPortGetDeviceBase