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 |
---|---|
|
Cette fonction n’est pas implémentée sur le système d’exploitation actif. |
|
Indique que les paramètres de performances ont été stockés dans StartIoPerfParams. |
|
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) |