Función StorPortGetSystemAddress (storport.h)

  • Artículo

La rutina StorPortGetSystemAddress devuelve una dirección virtual en el espacio del sistema para el búfer de datos del bloque de solicitud SCSI (SRB) especificado.

Sintaxis

ULONG StorPortGetSystemAddress(
  [in]  PVOID               HwDeviceExtension,
  [in]  PSCSI_REQUEST_BLOCK Srb,
  [out] PVOID               *SystemAddress
);

Parámetros

[in] HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).

[in] Srb

Puntero a una estructura SCSI_REQUEST_BLOCK .

[out] SystemAddress

Puntero para recibir la dirección virtual del búfer de datos.

Valor devuelto

StorPortGetSystemAddress devuelve uno de los siguientes códigos de estado:

Código devuelto Descripción
STOR_STATUS_NOT_IMPLEMENTED
 Esta función no se implementa en el sistema operativo activo.
STOR_STATUS_SUCCESS
 Indica que la dirección del sistema se obtuvo correctamente.
STOR_STATUS_INVALID_PARAMETER
 Este código de estado se debe a una de las siguientes condiciones:

La SRB no tiene un búfer de datos asociado.

El puntero para recibir la dirección virtual es NULL.
STOR_STATUS_INVALID_IRQL
 La llamada se realizó en un IRQL no válido.
STOR_STATUS_INSUFFICIENT_RESOURCES
 Error al intentar asignar el búfer de datos al espacio del sistema.

Comentarios

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 .

Requisitos

Requisito Value
Cliente mínimo compatible Esta rutina está disponible a partir de Windows Server 2003 con SP2.
Plataforma de destino Universal
Encabezado storport.h (incluya Storport.h)
IRQL <=DISPATCH_LEVEL
Reglas de cumplimiento de DDI StorPortIrql(storport)

Consulte también

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK