ACPI_OP_REGION_HANDLER fonction de rappel (oprghdlr.h)

Article
02/07/2025

Une routine ACPI_OP_REGION_HANDLER typée est fournie par un pilote de fonction d’appareil ACPI pour fournir l’accès par le pilote ACPI à la région d’opération de l’appareil.

Syntaxe

ACPI_OP_REGION_HANDLER AcpiOpRegionHandler;

NTSTATUS AcpiOpRegionHandler(
  ULONG AccessType,
  PVOID OperationRegionObject,
  ULONG Address,
  ULONG Size,
  PULONG Data,
  ULONG_PTR Context,
  PACPI_OP_REGION_CALLBACK CompletionHandler,
  PVOID CompletionContext
)
{...}

Paramètres

AccessType

Spécifie l’un des types d’accès suivants :

Type d’accès	Description
ACPI_OPREGION_WRITE	Écrivez dans la mémoire tampon de la région d’opération.
ACPI_OPREGION_READ	Lecture à partir de la mémoire tampon de la région d’opération.

OperationRegionObject

Spécifie l’objet de région d’opération retourné par RegisterOpRegionHandler pour le gestionnaire de région d’opération.

Address

Spécifie un décalage d’octet dans la mémoire tampon de la région d’opération. Selon le type d’accès, les données sont transférées vers ou depuis cet emplacement de mémoire.

Size

Spécifie le nombre d’octets à accéder.

Data

Pointeur vers la mémoire tampon de données fournie par le pilote ACPI associé à l’accès. Pour un accès en lecture, les octets sont transférés de la mémoire tampon de région d’opération vers la mémoire tampon de données. Pour un accès en écriture, les octets sont transférés de la mémoire tampon de données vers la mémoire tampon de la région d’opération.

Context

Pointeur vers le même contexte de région d’opération que le pilote de fonction spécifié lorsqu’il a inscrit le gestionnaire de région d’opération.

CompletionHandler

Réservé à une utilisation interne.

CompletionContext

Réservé à une utilisation interne.

Valeur de retour

Retourne l’une des valeurs d’état suivantes :

Retourner le code	Description
STATUS_SUCCESS	L’accès a réussi.
STATUS_INVALID_DEVICE_REQUEST	Le type d’accès n’est pas valide.
STATUS_Xxx	Une erreur interne s’est produite.

Remarques

Lorsque le pilote ACPI appelle un gestionnaire de région d’opération, il spécifie des valeurs pour Adresse et Taille qui garantissent que l’accès se trouve dans la région d’opération définie dans le BIOS ACPI pour l’appareil ACPI. Le pilote de fonction de périphérique ACPI doit s’assurer que la mémoire tampon de la région d’opération qu’elle alloue est au moins aussi importante, en octets, que la région d’opération définie pour l’appareil ACPI.

Pour plus d’informations sur les gestionnaires de région d’opération, consultez Prise en charge d’une région d’opération.

Une routine ACPI_OP_REGION_HANDLER typée s’exécute au niveau du runtime d’intégration de l’appelant.

Pour plus d’informations sur les contraintes sur les régions d’opération, consultez la spécification ACPI (Advanced Configuration and Power Interface).

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	oprghdlr.h (include Oprghdlr.h)

Voir aussi

DeRegisterOpRegionHandler

Partager via