Fonction StorPortPoFxActivateComponent (storport.h)
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 |
---|---|
|
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. |
|
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. |
|
L’adaptateur ou l’unité ne prend pas en charge PoFx. |
|
> DISPATCH_LEVEL IRQL actuel. |
|
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour