Funzione StorPortInvokeAcpiMethod (storport.h)

Articolo
02/07/2025

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 la scheda bus host (HBA).

[in, optional] Address

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

[in] MethodName

Nome a quattro byte per il metodo ACPI. Ad esempio, ((ULONG) 'DDS_') denomina il _SDD o 'Set Device Data', il metodo 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 di questi codici di stato:

Codice restituito	Descrizione
STOR_STATUS_INVALID_UNSUCCESSFUL	Esiste una condizione di errore generale.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension, InputBuffero OutputBuffer è NULL. -o- Address fa riferimento a una destinazione che non esiste.
STOR_STATUS_NOT_IMPLEMENTED	Il metodo ACPI non viene implementato.
STOR_STATUS_INSUFFICIENT_RESOURCES	Sono disponibili risorse insufficienti per eseguire il metodo o outputBufferLength non è sufficiente per i dati restituiti.
STOR_STATUS_INVALID_IRQL	> PASSIVE_LEVEL IRQL corrente.
STOR_STATUS_SUCCESS	Metodo eseguito correttamente.

Osservazioni

Il 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.

Fabbisogno

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