Função StorPortInvokeAcpiMethod (storport.h)

Artigo
02/07/2025

A rotina de StorPortInvokeAcpiMethod executa um método ACPI para um dispositivo de armazenamento.

Sintaxe

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

Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host).

[in, optional] Address

O endereço do dispositivo de destino. Esse parâmetro é opcional. Se Address estiver definido como NULL, o adaptador será o destino.

[in] MethodName

Um nome de quatro bytes para o método ACPI. Por exemplo, ((ULONG) 'DDS_') nomearia o _SDD ou o método ACPI "Definir Dados do Dispositivo" para um controlador AHCI.

[in, optional] InputBuffer

Um ponteiro para os dados de entrada para o método.

[in] InputBufferLength

O comprimento, em bytes, do buffer no InputBuffer.

[in, optional] OutputBuffer

Um ponteiro para os dados de saída do método.

[in] OutputBufferLength

O comprimento, em bytes, do buffer em outputbuffer.

[out, optional] BytesReturned

Um ponteiro para o comprimento, em bytes, dos dados retornados em OutputBuffer.

Valor de retorno

A rotina StorPortInvokeAcpiMethod retorna um destes códigos de status:

Código de retorno	Descrição
STOR_STATUS_INVALID_UNSUCCESSFUL	Existe uma condição de erro geral.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension, InputBufferou OutputBuffer é NULL. -ou- Address refere-se a um destino que não existe.
STOR_STATUS_NOT_IMPLEMENTED	O método ACPI não é implementado.
STOR_STATUS_INSUFFICIENT_RESOURCES	Recursos insuficientes estão disponíveis para executar o método ou OutputBufferLength não é grande o suficiente para os dados retornados.
STOR_STATUS_INVALID_IRQL	> PASSIVE_LEVEL IRQL atual.
STOR_STATUS_SUCCESS	O método foi executado com êxito.

Observações

O StorPortInvokeAcpiMethod permite que um driver de miniporto invoque métodos ACPI definidos para controladores de armazenamento e LUNs de armazenamento. Os nomes de método são cadeias de caracteres de quatro bytes que ocupam um valor de ULONG no MethodName.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows 8 e versões posteriores do Windows.
da Plataforma de Destino	Universal
cabeçalho	storport.h (inclua Storport.h)
IRQL	PASSIVE_LEVEL

Partilhar via