Partager via


Fonction StorPortGetStartIoPerfParams (storport.h)

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.

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 .

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête storport.h (inclure Storport.h)

Voir aussi

SCSI_REQUEST_BLOCK

STARTIO_PERFORMANCE_PARAMETERS

STORAGE_REQUEST_BLOCK