ACPI_OP_REGION_HANDLER fonction de rappel (oprghdlr.h)

Article
02/29/2024

Une routine de type ACPI_OP_REGION_HANDLER est fournie par un pilote de fonction de périphérique 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	Écrire dans la mémoire tampon de la région d’opération.
ACPI_OPREGION_READ	Lit à 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’octets 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 la 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 celui spécifié par le pilote de fonction lors de l’inscription du gestionnaire de région d’opération.

CompletionHandler

Réservé à un usage interne.

CompletionContext

Réservé à un usage interne.

Valeur retournée

Retourne l’une des valeurs status suivantes :

Code de retour	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’il alloue est au moins aussi grande, 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 de l’IRQL 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).

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	oprghdlr.h (inclure Oprghdlr.h)

Voir aussi

DeRegisterOpRegionHandler

Partager via