StorPortInitializePoFxPower, fonction (storport.h)

Article
02/07/2025

Un pilote miniport appelle StorPortInitializePoFxPower pour inscrire un appareil de stockage auprès du framework de gestion de l’alimentation (PoFx).

Syntaxe

ULONG StorPortInitializePoFxPower(
  [in]           PVOID             HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS     Address,
  [in]           PSTOR_POFX_DEVICE Device,
  [in, out]      PBOOLEAN          D3ColdEnabled
);

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’inscription d’une carte de stockage.

[in] Device

Pointeur vers une structure STOR_POFX_DEVICE_V2 cast vers un pointeur vers STOR_POFX_DEVICE. Cette structure contient une liste de composants avec des états F pour un appareil de stockage.

[in, out] D3ColdEnabled

Pointeur vers une valeur BOOLEAN que le pilote Storport définit pour indiquer si l’état froid D3 est activé pour l’appareil de stockage.

Valeur de retour

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

Retourner le code	Description
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- La structure STOR_POFX_DEVICE pointée par Device est mise en forme incorrectement ou contient des données non valides.
STOR_STATUS_SUCCESS	L’appareil de stockage a été correctement inscrit auprès de PoFx.
STOR_STATUS_INSUFFICIENT_RESOURCES	Les ressources suffisantes ne sont pas disponibles pour inscrire l’appareil de stockage auprès de PoFx.
STOR_STATUS_UNSUCCESSFUL	L’appareil de stockage n’a pas été correctement inscrit auprès de PoFx. -ou- L’appareil de stockage est déjà inscrit auprès de PoFx.

Remarques

Les appareils adaptateurs sont toujours inscrits avec une valeur de NULL pour adresse. Les appareils unitaires sont inscrits en spécifiant une adresse d’unité valide pour adresse.

Si l’indicateur STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD est défini dans les indicateurs de membre de Device, Storport tente d’activer la prise en charge D3 Cold pour le composant de l’appareil. L’état activé par le froid D3 est retourné dans la valeur BOOLEAN pointée par D3ColdEnabled .

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 8.
plateforme cible	Universel
d’en-tête	storport.h

Voir aussi

STOR_POFX_DEVICE

Partager via