StorPortInvokeAcpiMethod-Funktion (storport.h)

Artikel
02/29/2024

Die StorPortInvokeAcpiMethod-Routine führt eine ACPI-Methode für ein Speichergerät aus.

Syntax

ULONG StorPortInvokeAcpiMethod(
  [in]            PVOID         HwDeviceExtension,
  [in, optional]  PSTOR_ADDRESS Address,
  [in]            ULONG         MethodName,
  [in, optional]  PVOID         InputBuffer,
  [in]            ULONG         InputBufferLength,
  [in, optional]  PVOID         OutputBuffer,
  [in]            ULONG         OutputBufferLength,
  [out, optional] PULONG        BytesReturned
);

Parameter

[in] HwDeviceExtension

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

[in, optional] Address

Die Adresse des Zielgeräts. Dieser Parameter ist optional. Wenn Address auf NULL festgelegt ist, ist der Adapter das Ziel.

[in] MethodName

Ein Vier-Byte-Name für die ACPI-Methode. Beispielsweise würde ((ULONG) 'DDS_') die _SDD oder "Set Device Data", ACPI-Methode für einen AHCI-Controller nennen.

[in, optional] InputBuffer

Ein Zeiger auf die Eingabedaten für die -Methode.

[in] InputBufferLength

Die Länge des Puffers in InputBuffer in Bytes.

[in, optional] OutputBuffer

Ein Zeiger auf die Ausgabedaten der -Methode.

[in] OutputBufferLength

Die Länge des Puffers in OutputBuffer in Bytes.

[out, optional] BytesReturned

Ein Zeiger auf die Länge der in OutputBuffer zurückgegebenen Daten in Bytes.

Rückgabewert

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

Rückgabecode	Beschreibung
STOR_STATUS_INVALID_UNSUCCESSFUL	Es ist eine allgemeine Fehlerbedingung vorhanden.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension, InputBuffer oder OutputBuffer ist NULL. Oder Adresse bezieht sich auf ein Ziel, das nicht vorhanden ist.
STOR_STATUS_NOT_IMPLEMENTED	Die ACPI-Methode ist nicht implementiert.
STOR_STATUS_INSUFFICIENT_RESOURCES	Es sind nicht genügend Ressourcen zum Ausführen der Methode verfügbar, oder OutputBufferLength ist nicht groß genug für die zurückgegebenen Daten.
STOR_STATUS_INVALID_IRQL	Aktuelle IRQL-> PASSIVE_LEVEL.
STOR_STATUS_SUCCESS	Die Methode wurde erfolgreich ausgeführt.

Hinweise

Die StorPortInvokeAcpiMethod ermöglicht es einem Miniporttreiber, ACPI-Methoden aufzurufen, die für Speichercontroller und Speicher-LUNs definiert sind. Die Methodennamen sind Vier-Byte-Zeichenfolgen, die einen ULONG-Wert in MethodName belegen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 8 und höheren Versionen von Windows.
Zielplattform	Universell
Header	storport.h (Storport.h einschließen)
IRQL	PASSIVE_LEVEL

Freigeben über