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

Статья
02/07/2025

Подпрограмма 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

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

[in] MethodName

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

[in, optional] InputBuffer

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

[in] InputBufferLength

Длина буфера в InputBuffer.

[in, optional] OutputBuffer

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

[in] OutputBufferLength

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

[out, optional] BytesReturned

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

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

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

Возвращаемый код	Описание
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 (include Storport.h)
IRQL	PASSIVE_LEVEL

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