Fonction StorPortInitializePerfOpts (storport.h)

  • Article

La fonction StorPortInitializePerfOpts initialise les optimisations des performances prises en charge par le pilote miniport et le pilote Storport à l’aide d’une structure PERF_CONFIGURATION_DATA .

Syntaxe

ULONG StorPortInitializePerfOpts(
  [in]      PVOID                    HwDeviceExtension,
  [in]      BOOLEAN                  Query,
  [in, out] PPERF_CONFIGURATION_DATA PerfConfigData
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA). Ce paramètre ne doit pas avoir la valeur NULL.

[in] Query

S’il est défini sur TRUE, Storport définit les indicateurs dans PerfConfigData correspondant aux optimisations prise en charge par Storport. Si la valeur est FALSE, Storport initialise les optimisations spécifiées par les indicateurs dans PerfConfigData.

[in, out] PerfConfigData

Pointeur vers une structure PERF_CONFIGURATION_DATA fournie par le pilote miniport. Ce paramètre ne doit pas avoir la valeur NULL.

Valeur retournée

StorPortInitializePerfOpts 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 d’optimisation des performances ont été appliqués.

Ou si Query a la valeur TRUE, le membre Flags de la structure pointée par PerfConfigData contient les indicateurs pris en charge.
STOR_STATUS_UNSUCCESSFUL
 Le pilote miniport a défini un indicateur dans PerfConfigData que Storport n’a pas reconnu, ou le pilote miniport a appelé cette routine en dehors de la routine HwStorInitialize fournie par le miniport.
STOR_STATUS_INSUFFICIENT_RESOURCES
 Impossible d’allouer des structures internes pour prendre en charge les optimisations demandées.
STOR_STATUS_INVALID_PARAMETER
 Le paramètre HwDeviceExtension ou le paramètre PerfConfigData était NULL.

Remarques

Le pilote miniport peut appeler StorPortInitializePerfOpts uniquement pendant la routine HwStorInitialize fournie par miniport ou la routine HwStorPassiveInitializeRoutine .

Les optimisations des performances disponibles dépendent de la version de PERF_CONFIGURATION_DATA. La définition du membre Versionsur STOR_PERF_VERSION permet de sélectionner toutes les optimisations prises en charge.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête storport.h (inclure Storport.h)
Règles de conformité DDI StorPortPerfOpts(storport)

Voir aussi

PERF_CONFIGURATION_DATA