Fonction StorPortPoFxActivateComponent (storport.h)

Article
05/23/2024

La routine StorPortPoFxActivateComponent incrémente le nombre de références d’activation sur le composant spécifié d’un périphérique 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é de périphérique de stockage. Ce paramètre a la valeur 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 a la valeur NULL si le miniport active un composant d’appareil pour une requête non envoyée via Storport.

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

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans à partir de Windows 8.
Plateforme cible	Universal
En-tête	storport.h
Bibliothèque	Storport.lib
IRQL	IRQL <= DISPATCH_LEVEL

Voir aussi

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxIdleComponent

Partager via