StorPortInitializePoFxPower, fonction (storport.h)

Article
02/26/2024

Un pilote de miniport appelle StorPortInitializePoFxPower pour inscrire un périphérique de stockage auprès de l’infrastructure 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é de périphérique de stockage. Ce paramètre a la valeur NULL lors de l’inscription d’un adaptateur de stockage.

[in] Device

Pointeur vers une structure STOR_POFX_DEVICE_V2 converti en pointeur vers STOR_POFX_DEVICE. Cette structure contient une liste de composants avec des états F pour un périphérique 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 le périphérique de stockage.

Valeur retournée

La routine StorPortInitializePoFxPower retourne l’un des codes status suivants :

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

Remarques

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

Si l’indicateur STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD est défini dans le membre Indicateurs de l’appareil, Storport tente d’activer la prise en charge D3 Cold pour le composant de l’appareil. Le status D3 Activé à froid est retourné dans la valeur BOOLEAN pointée par D3ColdEnabled.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans à partir de Windows 8.
Plateforme cible	Universal
En-tête	storport.h

Voir aussi

STOR_POFX_DEVICE

Partager via