StorPortPoFxIdleComponent, fonction (storport.h)

Article
02/07/2025

Le StorPortPoFxIdleComponent décrémente le nombre de références d’activation d’un composant spécifié d’un appareil 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é d’appareil de stockage. Ce paramètre est NULL lors de l’idage d’un composant d’adaptateur de stockage.

[in, optional] Srb

SRB déclenchant la désactivation du composant. Ce paramètre est null si le miniport idling a un composant d’appareil en interne.

[in] Component

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

[in] Flags

Non utilisé. Défini sur 0.

Valeur de retour

La routine StorPortPoFxIdleComponent retourne l’un des codes d’état suivants :

Retourner le code	Description
STOR_STATUS_SUCCESS	La référence d’activation de l’appareil de stockage a été décrémentée avec succès et le composant est inactif.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension ou Device a la valeur NULL. -ou- Adresse pointe vers une structure d’adresse d’unité non valide. -ou- L’appareil de stockage spécifié par adresse est introuvable. -ou- L’appareil de stockage n’est pas inscrit auprès de l’infrastructure de gestion de l’alimentation (PoFx). -ou- La SRB pointée par Srb n’est pas envoyée à partir de Storport. -ou- Le paramètre Flags n’est pas 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 de inactif et un Srb pour lequel un appel précédent à StorPortPoFxActivateComponent n’a pas été effectué.
STOR_STATUS_INVALID_IRQL	La > DISPATCH_LEVEL IRQL actuelle.
STOR_STATUS_BUSY	La référence active du composant d’appareil a été décrémentée, mais le composant est toujours actif.

Remarques

Actuellement, les appareils d’adaptateur et les appareils d’unité 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.