Fonction StorPortGetStartIoPerfParams (storport.h)

Article
02/26/2024

La routine StorPortGetStartIoPerfParams place les paramètres de performances d’une requête d’E/S donnée dans une structure STARTIO_PERFORMANCE_PARAMETERS .

Syntaxe

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

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).

[in] Srb

Pointeur SRB transmis à la routine HwStorStartIo fournie par le pilote miniport. Ce paramètre ne doit pas avoir la valeur NULL.

[in, out] StartIoPerfParams

Pointeur vers une structure STARTIO_PERFORMANCE_PARAMETERS que le pilote miniport fournit. Le pilote miniport doit définir uniquement la taille de la structure allouée, car Storport définit les autres membres. Ce paramètre ne doit pas avoir la valeur NULL.

Valeur retournée

StorPortGetStartIoPerfParams retourne l’une des valeurs status suivantes :

Code de retour	Description
STOR_STATUS_NOT_IMPLEMENTED	Cette fonction n’est pas implémentée sur le système d’exploitation actif.
STOR_STATUS_SUCCESS	Indique que les paramètres de performances ont été stockés dans StartIoPerfParams.
STOR_STATUS_INVALID_PARAMETER	Le paramètre Srb ou le paramètre StartIoPerfParams a la valeur NULL. -ou- Le paramètre HwDeviceExtension est NULL ou non valide. -ou- Le paramètre Srb ne pointe pas vers un SRB envoyé par Storport -ou- La structure pointée par StartIoPerfParams n’est pas valide, car la valeur de son membre Size indique que la structure est trop petite pour contenir les données retournées.

Code de retour

Description

STOR_STATUS_NOT_IMPLEMENTED

Cette fonction n’est pas implémentée sur le système d’exploitation actif.

STOR_STATUS_SUCCESS

Indique que les paramètres de performances ont été stockés dans StartIoPerfParams.

STOR_STATUS_INVALID_PARAMETER

Le paramètre Srb ou le paramètre StartIoPerfParams a la valeur NULL.

-ou-

Le paramètre HwDeviceExtension est NULL ou non valide.

-ou-

Le paramètre Srb ne pointe pas vers un SRB envoyé par Storport

-ou-

La structure pointée par StartIoPerfParams n’est pas valide, car la valeur de son membre Size indique que la structure est trop petite pour contenir les données retournées.

Remarques

À partir de Windows 8, le paramètre Srb peut pointer vers SCSI_REQUEST_BLOCK ou STORAGE_REQUEST_BLOCK. Si l’identificateur de fonction dans le champ Fonction de Srb est SRB_FUNCTION_STORAGE_REQUEST_BLOCK, le SRB est une structure de requête STORAGE_REQUEST_BLOCK .