StorPortPoFxIdleComponent, fonction (storport.h)

Article
03/01/2024

La routine StorPortPoFxIdleComponent décrémente le nombre de références d’activation d’un composant spécifié d’un périphérique de stockage.

Syntaxe

ULONG StorPortPoFxIdleComponent(
  [in]           PVOID               HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS       Address,
  [in, optional] PSCSI_REQUEST_BLOCK Srb,
  [in]           ULONG               Component,
  [in]           ULONG               Flags
);

Paramètres

[in] HwDeviceExtension

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

[in, optional] Address

Adresse d’une unité de périphérique de stockage. Ce paramètre a la valeur NULL lors de la mise au point d’un composant d’adaptateur de stockage.

[in, optional] Srb

SRB déclenchant la désactivation du composant. Ce paramètre a la valeur NULL si le miniport exécute un composant d’appareil en interne.

[in] Component

Index qui identifie le composant. Ce paramètre est un index dans le tableau Components de la structure STOR_POFX_DEVICE que le pilote miniport a inscrit pour l’appareil avec un appel à StorPortInitializePoFxPower. Si le tableau Components contient N éléments, les index de composant vont de 0 à N–1.

[in] Flags

Non utilisé. Définit la valeur 0.

Valeur retournée

La routine StorPortPoFxIdleComponent retourne l’un des codes status suivants :

Code de retour	Description
STOR_STATUS_SUCCESS	La référence d’activation du périphérique de stockage a été décrémentée et le composant est inactif.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension ou Device a la valeur NULL. -ou- L’adresse pointe vers une structure d’adresse d’unité non valide. -ou- Le périphérique de stockage spécifié par Address est introuvable. -ou- Le périphérique de stockage n’est pas inscrit auprès de l’infrastructure de gestion de l’alimentation (PoFx). -ou- Le SRB pointé par Srb n’est pas envoyé par Storport. -ou- Le paramètre Flags est différent de zéro.
STOR_STATUS_INVALID_DEVICE_REQUEST	L’adaptateur ou l’unité ne prend pas en charge PoFx. -ou- StorPortPoFxIdleComponent a été appelé avec un composant inactif et un Srb pour lequel aucun appel précédent à StorPortPoFxActivateComponent n’a été effectué.
STOR_STATUS_INVALID_IRQL	> DISPATCH_LEVEL IRQL actuel.
STOR_STATUS_BUSY	La référence active pour le composant d’appareil a été décrémentée, mais le composant est toujours actif.

Remarques

Actuellement, les périphériques adaptateurs et les appareils unitaires ont un nombre maximal de composants de 1. L’index dans Composant doit toujours être défini sur 0.

Chaque appel à StorPortPoFxIdleComponent doit être mis en correspondance avec un appel précédent à StorPortPoFxActivateComponent.