Función StorPortGetScatterGatherList (storport.h)

Artículo
02/29/2024

La rutina StorPortGetScatterGatherList recupera la lista de dispersión o recopilación asociada para el bloque de solicitud SCSI (SRB) especificado.

Sintaxis

STORPORT_API PSTOR_SCATTER_GATHER_LIST StorPortGetScatterGatherList(
  [in] PVOID               HwDeviceExtension,
  [in] PSCSI_REQUEST_BLOCK Srb
);

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 para el HBA. Esta área está disponible para el miniporte inmediatamente después de que el controlador de minipuerto llame a StorPortInitialize. El controlador de puerto libera esta memoria cuando quita el dispositivo.

[in] Srb

Puntero a la SRB para la que se va a construir la lista de recopilación de dispersión.

Valor devuelto

StorPortGetScatterGatherList devuelve un puntero a la lista de dispersión y recopilación.

Comentarios

Esta rutina se proporciona con la biblioteca de controladores de Storport. No hay ninguna rutina paralela proporcionada en la biblioteca de puertos SCSI.

El puntero a la lista de dispersión y recopilación que se devuelve solo es válido hasta que se completa la SRB.

El controlador de minipuerto no tiene que liberar la memoria de la lista de dispersión o recopilación que devuelve StorPortGetScatterGatherList .

El controlador de minipuerto no debe modificar la lista de dispersión o recopilación.

A partir de Windows 8, el parámetro Srb puede apuntar a SCSI_REQUEST_BLOCK o STORAGE_REQUEST_BLOCK. Si el identificador de función del campo Función de Srb es SRB_FUNCTION_STORAGE_REQUEST_BLOCK, el SRB es una estructura de solicitud STORAGE_REQUEST_BLOCK .