Funzione StorPortInvokeAcpiMethod (storport.h)

Articolo
08/07/2023

La routine StorPortInvokeAcpiMethod esegue un metodo ACPI per un dispositivo di archiviazione.

Sintassi

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

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per l'adattatore bus host (HBA).

[in, optional] Address

Indirizzo del dispositivo di destinazione. Questo parametro è facoltativo e, Se Address è impostato su NULL, l'adapter è la destinazione.

[in] MethodName

Nome a quattro byte per il metodo ACPI. Ad esempio, ((ULONG) 'DDS_') denomina il _SDD o il metodo 'Set Device Data', ACPI per un controller AHCI.

[in, optional] InputBuffer

Puntatore ai dati di input al metodo .

[in] InputBufferLength

Lunghezza, in byte, del buffer in InputBuffer.

[in, optional] OutputBuffer

Puntatore ai dati di output dal metodo .

[in] OutputBufferLength

Lunghezza, in byte, del buffer in OutputBuffer.

[out, optional] BytesReturned

Puntatore alla lunghezza, in byte, dei dati restituiti in OutputBuffer.

Valore restituito

La routine StorPortInvokeAcpiMethod restituisce uno dei codici di stato seguenti:

Codice restituito	Descrizione
STOR_STATUS_INVALID_UNSUCCESSFUL	Esiste una condizione di errore generale.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension, InputBuffer o OutputBuffer è NULL. -oppure- L'indirizzo fa riferimento a una destinazione che non esiste.
STOR_STATUS_NOT_IMPLEMENTED	Il metodo ACPI non è implementato.
STOR_STATUS_INSUFFICIENT_RESOURCES	Sono disponibili risorse insufficienti per eseguire il metodo oppure OutputBufferLength non è sufficientemente grande per i dati restituiti.
STOR_STATUS_INVALID_IRQL	> PASSIVE_LEVEL IRQL corrente.
STOR_STATUS_SUCCESS	Metodo eseguito correttamente.

Commenti

StorPortInvokeAcpiMethod consente a un driver miniport di richiamare i metodi ACPI definiti per i controller di archiviazione e i LUN di archiviazione. I nomi dei metodi sono stringhe di caratteri a quattro byte che occupano un valore ULONG in NomeMetodo.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 8 e versioni successive di Windows.
Piattaforma di destinazione	Universale
Intestazione	storport.h (include Storport.h)
IRQL	PASSIVE_LEVEL

Condividi tramite