RegisterOpRegionHandler, fonction (oprghdlr.h)

Article
02/26/2024

La routine RegisterOpRegionHandler inscrit un gestionnaire de région d’opération auprès du pilote ACPI.

Syntaxe

NTSTATUS RegisterOpRegionHandler(
  [in]  PDEVICE_OBJECT          DeviceObject,
  [in]  ULONG                   AccessType,
  [in]  ULONG                   RegionSpace,
  [in]  PACPI_OP_REGION_HANDLER Handler,
  [in]  PVOID                   Context,
  [in]  ULONG                   Flags,
  [out] PVOID                   *OperationRegionObject
);

Paramètres

[in] DeviceObject

Pointeur vers l’objet d’appareil physique (PDO) qui représente l’appareil ACPI qui définit la région d’opération.

[in] AccessType

Spécifie ACPI_OPREGION_ACCESS_AS_COOKED.

[in] RegionSpace

Spécifie l’un des types suivants d’espace de région.

Identificateur d’espace de région	Description
ACPI_OPREGION_REGION_SPACE_MEMORY	Mémoire système
ACPI_OPREGION_REGION_SPACE_IO	Espace d’E/S
ACPI_OPREGION_REGION_SPACE_PCI_CONFIG	Configuration PCI
ACPI_OPREGION_REGION_SPACE_EC	Contrôleur incorporé
ACPI_OPREGION_REGION_SPACE_SMB	Bus de gestion système
ACPI_OPREGION_REGION_SPACE_CMOS_CONFIG	Configuration CMOS
ACPI_OPREGION_REGION_SPACE_PCIBARTARGET	Registre d’adresses de base PCI
Valeur définie par le fournisseur de 0x80 à 0xFF	Défini par le fournisseur

[in] Handler

Pointeur vers le gestionnaire de région d’opération de type ACPI_OP_REGION_HANDLER (fourni par un pilote de fonction de périphérique ACPI).

[in] Context

Pointeur vers un contexte de région d’opération spécifique au périphérique (fourni par un pilote de fonction de périphérique ACPI).

[in] Flags

Réservé à un usage interne.

[out] OperationRegionObject

Pointeur vers la mémoire tampon allouée à l’appelant qui, lors de la sortie, contient un pointeur vers l’objet de région d’opération que le pilote ACPI crée pour la région d’opération.

Valeur retournée

Retourne l’une des valeurs status suivantes :

Code de retour	Description
STATUS_SUCCESS	Le gestionnaire de la région d’exploitation a été correctement inscrit.
STATUS_ACPI_INVALID_DATA	Les informations spécifiées ne sont pas valides.
STATUS_INSUFFICIENT_RESOURCES	La routine n’a pas pu allouer les ressources système nécessaires.
STATUS_Xxx	Une erreur interne s’est produite.

Remarques

Le contexte de région d’opération spécifié par Context est spécifique au périphérique et est utilisé uniquement par le pilote de fonction. En règle générale, le contexte est l’extension d’appareil pour l’objet d’appareil fonctionnel (FDO). Le pilote ACPI transmet ce contexte au pilote de fonction lorsqu’il appelle le gestionnaire de région d’opération. L’objet de région d’opération est utilisé uniquement par un pilote de fonction pour identifier de manière unique la région d’opération lorsqu’il annule l’inscription du gestionnaire de région d’opération.

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

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	oprghdlr.h (inclure Oprghdlr.h)
Bibliothèque	Oprghdlr.lib
IRQL	PASSIVE_LEVEL

Voir aussi

ACPI_OP_REGION_HANDLER

DeRegisterOpRegionHandler

Partager via