Funzione RegisterOpRegionHandler (oprghdlr.h)

Articolo
02/29/2024

La routine RegisterOpRegionHandler registra un gestore dell'area dell'operazione con il driver ACPI.

Sintassi

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

Parametri

[in] DeviceObject

Puntatore all'oggetto dispositivo fisico (PDO) che rappresenta il dispositivo ACPI che definisce l'area dell'operazione.

[in] AccessType

Specifica ACPI_OPREGION_ACCESS_AS_COOKED.

[in] RegionSpace

Specifica uno dei tipi di spazio dell'area seguenti.

Identificatore dello spazio area	Descrizione
ACPI_OPREGION_REGION_SPACE_MEMORY	Memoria di sistema
ACPI_OPREGION_REGION_SPACE_IO	Spazio di I/O
ACPI_OPREGION_REGION_SPACE_PCI_CONFIG	Configurazione PCI
ACPI_OPREGION_REGION_SPACE_EC	Controller incorporato
ACPI_OPREGION_REGION_SPACE_SMB	Bus di gestione del sistema
ACPI_OPREGION_REGION_SPACE_CMOS_CONFIG	Configurazione DI IMAGE
ACPI_OPREGION_REGION_SPACE_PCIBARTARGET	Registro degli indirizzi di base PCI
Valore definito dal fornitore da 0x80 a 0xFF	Definito dal fornitore

[in] Handler

Puntatore al gestore dell'area dell'operazione tipizzata ACPI_OP_REGION_HANDLER (fornito da un driver di funzione del dispositivo ACPI).

[in] Context

Puntatore a un contesto dell'area dell'operazione specifica del dispositivo (fornito da un driver di funzione del dispositivo ACPI).

[in] Flags

Riservato per utilizzo interno.

[out] OperationRegionObject

Puntatore al buffer allocato dal chiamante che, nell'output, contiene un puntatore all'oggetto area dell'operazione creato dal driver ACPI per l'area dell'operazione.

Valore restituito

Restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Il gestore dell'area operativa è stato registrato correttamente.
STATUS_ACPI_INVALID_DATA	Le informazioni specificate non sono valide.
STATUS_INSUFFICIENT_RESOURCES	La routine non è riuscita ad allocare le risorse di sistema necessarie.
STATUS_Xxx	An internal error occurred.

Commenti

Il contesto dell'area dell'operazione specificato da Context è specifico del dispositivo e viene usato solo dal driver di funzione. In genere, il contesto è l'estensione del dispositivo per l'oggetto dispositivo funzionale (FDO). Il driver ACPI passa di nuovo questo contesto al driver di funzione quando chiama il gestore dell'area dell'operazione. L'oggetto area dell'operazione viene usato solo da un driver di funzione per identificare in modo univoco l'area dell'operazione quando annulla la registrazione del gestore dell'area dell'operazione.

Per altre informazioni sulle aree operative, vedere Supporto di un'area operativa.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	oprghdlr.h (include Oprghdlr.h)
Libreria	Oprghdlr.lib
IRQL	PASSIVE_LEVEL

Vedi anche

ACPI_OP_REGION_HANDLER

DeRegisterOpRegionHandler

Condividi tramite