Función StorPortInvokeAcpiMethod (storport.h)

La rutina StorPortInvokeAcpiMethod ejecuta un método ACPI para un dispositivo de almacenamiento.

Sintaxis

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
);

Parámetros

[in] HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).

[in, optional] Address

Dirección del dispositivo de destino. Este parámetro es opcional. Si dirección se establece en NULL, el adaptador es el destino.

[in] MethodName

Nombre de cuatro bytes para el método ACPI. Por ejemplo, ((ULONG) "DDS_") denominaría el _SDD, o "Establecer datos de dispositivo", método ACPI para un controlador AHCI.

[in, optional] InputBuffer

Puntero a los datos de entrada al método .

[in] InputBufferLength

Longitud, en bytes, del búfer en InputBuffer.

[in, optional] OutputBuffer

Puntero a los datos de salida del método .

[in] OutputBufferLength

Longitud, en bytes, del búfer en OutputBuffer.

[out, optional] BytesReturned

Puntero a la longitud, en bytes, de los datos devueltos en OutputBuffer.

Valor devuelto

La rutina StorPortInvokeAcpiMethod devuelve uno de estos códigos de estado:

Código devuelto	Descripción
STOR_STATUS_INVALID_UNSUCCESSFUL	Existe una condición de error general.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension, InputBuffero outputBuffer es NULL. -o- address hace referencia a un destino que no existe.
STOR_STATUS_NOT_IMPLEMENTED	El método ACPI no se implementa.
STOR_STATUS_INSUFFICIENT_RESOURCES	Los recursos insuficientes están disponibles para ejecutar el método o outputBufferLength no es lo suficientemente grande para los datos devueltos.
STOR_STATUS_INVALID_IRQL	> PASSIVE_LEVEL irQL actual.
STOR_STATUS_SUCCESS	El método se ejecutó correctamente.

Observaciones

El storPortInvokeAcpiMethod permite que un controlador de miniporte invoque métodos ACPI definidos para controladores de almacenamiento y LUN de almacenamiento. Los nombres de método son cadenas de caracteres de cuatro bytes que ocupan un valor de ULONG en MethodName.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows 8 y versiones posteriores de Windows.
de la plataforma de destino de	Universal
encabezado de	storport.h (incluya Storport.h)
irQL	PASSIVE_LEVEL