StorPortInvokeAcpiMethod, fonction (storport.h)

Article
02/07/2025

La routine StorPortInvokeAcpiMethod exécute une méthode ACPI pour un périphérique de stockage.

Syntaxe

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

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).

[in, optional] Address

Adresse de l’appareil cible. Ce paramètre est facultatif. Si adresse est définie sur NULL, l’adaptateur est la cible.

[in] MethodName

Nom de quatre octets pour la méthode ACPI. Par exemple, ((ULONG) 'DDS_') nomme l'_SDD, ou 'Set Device Data', méthode ACPI pour un contrôleur AHCI.

[in, optional] InputBuffer

Pointeur vers les données d’entrée vers la méthode.

[in] InputBufferLength

Longueur, en octets, de la mémoire tampon dans InputBuffer.

[in, optional] OutputBuffer

Pointeur vers les données de sortie de la méthode.

[in] OutputBufferLength

Longueur, en octets, de la mémoire tampon dans OutputBuffer.

[out, optional] BytesReturned

Pointeur vers la longueur, en octets, des données retournées dans OutputBuffer.

Valeur de retour

La routine StorPortInvokeAcpiMethod retourne l’un des codes d’état suivants :

Retourner le code	Description
STOR_STATUS_INVALID_UNSUCCESSFUL	Une condition d’erreur générale existe.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension, InputBufferou OutputBuffer a la valeur NULL. -ou- adresse fait référence à une cible qui n’existe pas.
STOR_STATUS_NOT_IMPLEMENTED	La méthode ACPI n’est pas implémentée.
STOR_STATUS_INSUFFICIENT_RESOURCES	Les ressources insuffisantes sont disponibles pour exécuter la méthode, ou OutputBufferLength n’est pas suffisamment grande pour les données retournées.
STOR_STATUS_INVALID_IRQL	> PASSIVE_LEVEL IRQL actuel.
STOR_STATUS_SUCCESS	La méthode a été exécutée avec succès.

Remarques

L'StorPortInvokeAcpiMethod permet à un pilote miniport d’appeler des méthodes ACPI définies pour les contrôleurs de stockage et les NUMÉROS logiques de stockage. Les noms de méthode sont des chaînes de caractères de quatre octets qui occupent une valeur de ULONG dans MethodName.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows 8 et versions ultérieures de Windows.
plateforme cible	Universel
d’en-tête	storport.h (include Storport.h)
IRQL	PASSIVE_LEVEL

Partager via