StorPortIsDeviceOperationAllowed, fonction (storport.h)

Article
02/29/2024

Un pilote miniport peut appeler la routine StorPortIsDeviceOperationAllowedminiport pour déterminer si les opérations pour une certaine classe de gestion des appareils sont autorisées. Une valeur status est définie dans le paramètre de retour pour indiquer si ces opérations sont autorisées ou non 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é de périphérique 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. Dans le cas contraire, la valeur est FALSE.

Valeur retournée

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

Code de retour	Description
STOR_STATUS_SUCCESS	Une valeur valide pour AllowedFlag a été retournée.
STOR_STATUS_INVALID_PARAMETER	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 valeur du pointeur dans AllowedFlag est NULL.
STOR_STATUS_INVALID_IRQL	La > PASSIVE_LEVEL IRQL actuelle.
STOR_STATUS_NOT_IMPLEMENTED	La classe de gestion spécifiée dans DeviceOperation n’est pas disponible ou non valide.

Configuration requise

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

Share via