Función StorPortGetStartIoPerfParams (storport.h)

Artículo
02/26/2024

La rutina StorPortGetStartIoPerfParams coloca los parámetros de rendimiento de una solicitud de E/S determinada en una estructura de STARTIO_PERFORMANCE_PARAMETERS .

Sintaxis

ULONG StorPortGetStartIoPerfParams(
  [in]      PVOID                           HwDeviceExtension,
  [in]      PSCSI_REQUEST_BLOCK             Srb,
  [in, out] PSTARTIO_PERFORMANCE_PARAMETERS StartIoPerfParams
);

Parámetros

[in] HwDeviceExtension

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

[in] Srb

Puntero SRB que se pasó a la rutina HwStorStartIo proporcionada por el controlador de minipuerto. Este parámetro no debe ser NULL.

[in, out] StartIoPerfParams

Puntero a una estructura STARTIO_PERFORMANCE_PARAMETERS que suministra el controlador de miniporte. El controlador de minipuerto debe establecer solo el tamaño de la estructura asignada, ya que Storport establecerá los demás miembros. Este parámetro no debe ser NULL.

Valor devuelto

StorPortGetStartIoPerfParams devuelve uno de los siguientes valores 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 los parámetros de rendimiento se han almacenado en StartIoPerfParams.
STOR_STATUS_INVALID_PARAMETER	El parámetro Srb o el parámetro StartIoPerfParams son NULL. O bien El parámetro HwDeviceExtension es NULL o no es válido. O bien El parámetro Srb no apunta a un SRB enviado por Storport O bien La estructura a la que apunta StartIoPerfParams no es válida porque el valor de su miembro Size indica que la estructura es demasiado pequeña para contener los datos devueltos.

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 los parámetros de rendimiento se han almacenado en StartIoPerfParams.

STOR_STATUS_INVALID_PARAMETER

El parámetro Srb o el parámetro StartIoPerfParams son NULL.

O bien

El parámetro HwDeviceExtension es NULL o no es válido.

O bien

El parámetro Srb no apunta a un SRB enviado por Storport

O bien

La estructura a la que apunta StartIoPerfParams no es válida porque el valor de su miembro Size indica que la estructura es demasiado pequeña para contener los datos devueltos.

Comentarios

A partir de Windows 8, el parámetro Srb puede apuntar a SCSI_REQUEST_BLOCK o a 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 .