Поделиться через

Функция StorPortInvokeAcpiMethod (storport.h)

  • Статья

Подпрограмма StorPortInvokeAcpiMethod выполняет метод ACPI для запоминающего устройства.

Синтаксис

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

Параметры

[in] HwDeviceExtension

Указатель на расширение аппаратного устройства для адаптера шины узла (HBA).

[in, optional] Address

Адрес целевого устройства. Этот параметр является необязательным. Если для параметра Address задано значение NULL, адаптер является целевым объектом.

[in] MethodName

Четырехбайтовое имя метода ACPI. Например, ((ULONG) "DDS_") будет называть _SDD или "Set Device Data" метод ACPI для контроллера AHCI.

[in, optional] InputBuffer

Указатель на входные данные метода .

[in] InputBufferLength

Длина буфера в InputBuffer (в байтах).

[in, optional] OutputBuffer

Указатель на выходные данные из метода .

[in] OutputBufferLength

Длина буфера в OutputBuffer (в байтах).

[out, optional] BytesReturned

Указатель на длину (в байтах) данных, возвращаемых в OutputBuffer.

Возвращаемое значение

Подпрограмма StorPortInvokeAcpiMethod возвращает один из следующих кодов состояния:

Код возврата Описание
STOR_STATUS_INVALID_UNSUCCESSFUL
 Существует общее условие ошибки.
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension, InputBuffer или OutputBuffer имеет значение NULL.

-или-

Адрес относится к целевому объекту, который не существует.
STOR_STATUS_NOT_IMPLEMENTED
 Метод ACPI не реализован.
STOR_STATUS_INSUFFICIENT_RESOURCES
 Недостаточно ресурсов для выполнения метода или OutputBufferLength недостаточно велик для возвращаемых данных.
STOR_STATUS_INVALID_IRQL
 Текущая > PASSIVE_LEVEL IRQL.
STOR_STATUS_SUCCESS
 Метод успешно выполнен.

Комментарии

StorPortInvokeAcpiMethod позволяет драйверу мини-порта вызывать методы ACPI, определенные для контроллеров хранилища и LUN хранилища. Имена методов представляют собой четырехбайтовые символьные строки, которые занимают значение ULONG в MethodName.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 8 и более поздних версиях Windows.
Целевая платформа Универсальное
Верхняя часть storport.h (включая Storport.h)
IRQL PASSIVE_LEVEL