StorPortInvokeAcpiMethod-Funktion (storport.h)

Artikel
02/07/2025

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 Hostbusadapter (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_") den _SDD oder die ACPI-Methode für einen AHCI-Controller benennen.

[in, optional] InputBuffer

Ein Zeiger auf die Eingabedaten auf die Methode.

[in] InputBufferLength

Die Länge des Puffers in Bytes in InputBuffer-.

[in, optional] OutputBuffer

Ein Zeiger auf die Ausgabedaten aus der Methode.

[in] OutputBufferLength

Die Länge des Puffers in Bytes in OutputBuffer.

[out, optional] BytesReturned

Ein Zeiger auf die Länge der in OutputBufferzurückgegebenen Daten in Byte.

Rückgabewert

Die StorPortInvokeAcpiMethod Routine gibt einen der folgenden Statuscodes zurück:

Rückgabecode	Beschreibung
STOR_STATUS_INVALID_UNSUCCESSFUL	Eine allgemeine Fehlerbedingung ist vorhanden.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension, InputBuffer-oder OutputBuffer- ist NULL. -oder- Address bezieht sich auf ein nicht vorhandenes Ziel.
STOR_STATUS_NOT_IMPLEMENTED	Die ACPI-Methode ist nicht implementiert.
STOR_STATUS_INSUFFICIENT_RESOURCES	Unzureichende Ressourcen stehen zur Ausführung der Methode zur Verfügung, oder OutputBufferLength- für die zurückgegebenen Daten nicht groß genug ist.
STOR_STATUS_INVALID_IRQL	Aktuelle IRQL-> PASSIVE_LEVEL.
STOR_STATUS_SUCCESS	Die Methode wurde erfolgreich ausgeführt.

Bemerkungen

Mit dem StorPortInvokeAcpiMethod- kann ein Miniporttreiber ACPI-Methoden aufrufen, die für Speichercontroller und Speicher-LUNs definiert sind. Bei den Methodennamen handelt es sich um Zeichenfolgen mit vier Bytezeichen, die einen ULONG- Wert in MethodName-belegen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 8 und höheren Versionen von Windows.
Zielplattform-	Universal
Header-	storport.h (include Storport.h)
IRQL-	PASSIVE_LEVEL

Freigeben über