StorPortIsDeviceOperationAllowed-Funktion (storport.h)

Artikel
02/29/2024

Ein Miniporttreiber kann die StorPortIsDeviceOperationAllowedminiport-Routine aufrufen, um zu bestimmen, ob Vorgänge für eine bestimmte Geräteverwaltungsklasse zulässig sind. Ein status Wert wird im Rückgabeparameter festgelegt, um anzugeben, ob solche Vorgänge für das Gerät in seiner aktuellen Betriebsumgebung zulässig oder nicht zulässig sind.

Syntax

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

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Hardwaregeräteerweiterung für den Host bus adapter (HBA).

[in] Address

Die Adresse einer Speichergeräteeinheit.

[in] DeviceOperation

Ein Zeiger auf eine GUID, die eine Geräteverwaltungsvorgangsklasse angibt. Die folgende GUID ist gültig.

Wert	Bedeutung
STORPORT_DEVICEOPERATION_SECURE_REPROVISION_GUID	Das Gerät ist für den Empfang gesicherter Bereitstellungsbefehle aktiviert.

[out] AllowedFlag

TRUE, wenn der in DeviceOperation angegebene Vorgang zulässig ist. Andernfalls lautet der Wert FALSE.

Rückgabewert

Die StorPortIsDeviceOperationAllowed-Routine gibt einen der folgenden status Codes zurück:

Rückgabecode	Beschreibung
STOR_STATUS_SUCCESS	Ein gültiger Wert für AllowedFlag wurde zurückgegeben.
STOR_STATUS_INVALID_PARAMETER	Address verweist auf eine ungültige Einheitenadressstruktur. Oder Das durch Adresse angegebene Speichergerät wurde nicht gefunden. Oder Der Zeigerwert in AllowedFlag ist NULL.
STOR_STATUS_INVALID_IRQL	Die aktuelle IRQL-> PASSIVE_LEVEL.
STOR_STATUS_NOT_IMPLEMENTED	Die in DeviceOperation angegebene Verwaltungsklasse ist nicht verfügbar oder ungültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.1.
Zielplattform	Universell
Header	storport.h
IRQL	IRQL == PASSIVE_LEVEL

Freigeben über