StorPortPoFxActivateComponent, fonction (storport.h)

Article
02/07/2025

Le StorPortPoFxActivateComponent routine incrémente le nombre de références d’activation sur le composant spécifié d’un appareil de stockage.

Syntaxe

ULONG StorPortPoFxActivateComponent(
  [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’activation d’un composant d’adaptateur de stockage.

[in, optional] Srb

SRB déclenchant l’activation du composant. Ce paramètre est null si le miniport active un composant d’appareil pour une demande non envoyée via Storport.

[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 StorPortPoFxActivateComponent 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é incrémentée avec succès et le composant est dans l’état actif.
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.
STOR_STATUS_INVALID_IRQL	La > DISPATCH_LEVEL IRQL actuelle.
STOR_STATUS_BUSY	La référence d’activation de l’appareil de stockage a été incrémentée avec succès, mais le composant est toujours dans l’état inactif

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 à StorPortPoFxActivateComponent doit être mis en correspondance avec un appel ultérieur à StorPortPoFxIdleComponent.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 8.
plateforme cible	Universel
d’en-tête	storport.h
bibliothèque	Storport.lib
IRQL	IRQL <= DISPATCH_LEVEL

Voir aussi

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxIdleComponent

Partager via