StorPortPoFxIdleComponent, fonction (storport.h)
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 |
---|---|
|
La référence d’activation du périphérique de stockage a été décrémentée et le composant est inactif. |
|
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.
-ou- StorPortPoFxIdleComponent a été appelé avec un composant inactif et un Srb pour lequel aucun appel précédent à StorPortPoFxActivateComponent n’a été effectué. |
|
> DISPATCH_LEVEL IRQL actuel. |
|
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.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible dans à partir de Windows 8. |
Plateforme cible | Universal |
En-tête | storport.h |
IRQL | Quelconque |
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