Partager via

StorPortIsDeviceOperationAllowed, fonction (storport.h)

  • Article

Un pilote miniport peut appeler la routine StorPortIsDeviceOperationAllowedminiport pour déterminer si des opérations pour une certaine classe de gestion d’appareil sont autorisées. Une valeur d’état est définie dans le paramètre de retour pour indiquer si ces opérations sont autorisées ou non autorisées pour l’appareil dans son environnement d’exploitation actuel.

Syntaxe

ULONG StorPortIsDeviceOperationAllowed(
  [in]  PVOID         HwDeviceExtension,
  [in]  PSTOR_ADDRESS Address,
  [in]  LPCGUID       DeviceOperation,
  [out] ULONG         *AllowedFlag
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).

[in] Address

Adresse d’une unité d’appareil de stockage.

[in] DeviceOperation

Pointeur vers un GUID spécifiant une classe d’opération de gestion des appareils. Le GUID suivant est valide.

Valeur Signification
STORPORT_DEVICEOPERATION_SECURE_REPROVISION_GUID
 L’appareil est activé pour recevoir des commandes d’approvisionnement sécurisées.

[out] AllowedFlag

TRUE lorsque l’opération spécifiée dans DeviceOperation est autorisée. Sinon, FALSE.

Valeur de retour

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

Retourner le code Description
STOR_STATUS_SUCCESS
 Une valeur valide pour allowedFlag a été retournée.
STOR_STATUS_INVALID_PARAMETER
 Adresse pointe vers une structure d’adresse d’unité non valide.

-ou-

L’appareil de stockage spécifié par adresse est introuvable.

-ou-

La valeur du pointeur dans AllowedFlag est NULL.
STOR_STATUS_INVALID_IRQL
 Le > PASSIVE_LEVEL IRQL actuel.
STOR_STATUS_NOT_IMPLEMENTED
 La classe de gestion spécifiée dans DeviceOperation n’est pas disponible ou non valide.

Exigences

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