Compartir a través de

Función StorPortInvokeAcpiMethod (storport.h)

  • Artículo

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 Address 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 el método "Set Device Data", 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, InputBuffer o OutputBuffer es NULL.

O bien

La dirección 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.

Comentarios

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 ULONG en MethodName.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows 8 y versiones posteriores de Windows.
Plataforma de destino Universal
Encabezado storport.h (incluya Storport.h)
IRQL PASSIVE_LEVEL