Función RegisterOpRegionHandler (oprghdlr.h)

La rutina RegisterOpRegionHandler registra un controlador de región de operación con el controlador ACPI de .

Sintaxis

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

Parámetros

[in] DeviceObject

Puntero al objeto de dispositivo físico (PDO) que representa el dispositivo ACPI que define la región de operación.

[in] AccessType

Especifica ACPI_OPREGION_ACCESS_AS_COOKED.

[in] RegionSpace

Especifica uno de los siguientes tipos de espacio de región.

Identificador de espacio de región Descripción
ACPI_OPREGION_REGION_SPACE_MEMORY Memoria del sistema
ACPI_OPREGION_REGION_SPACE_IO Espacio de E/S
ACPI_OPREGION_REGION_SPACE_PCI_CONFIG Configuración de PCI
ACPI_OPREGION_REGION_SPACE_EC Controlador incrustado
ACPI_OPREGION_REGION_SPACE_SMB Bus de administración del sistema
ACPI_OPREGION_REGION_SPACE_CMOS_CONFIG Configuración de CMOS
ACPI_OPREGION_REGION_SPACE_PCIBARTARGET Registro de direcciones base pci
Valor definido por el proveedor de 0x80 a 0xFF Definido por el proveedor

[in] Handler

Puntero al controlador de región de operación con tipo ACPI_OP_REGION_HANDLER(proporcionado por un controlador de función de dispositivo ACPI).

[in] Context

Puntero a un contexto de región de operación específica del dispositivo (proporcionado por un controlador de función de dispositivo ACPI).

[in] Flags

Reservado para uso interno.

[out] OperationRegionObject

Puntero al búfer asignado por el autor de la llamada que, en la salida, contiene un puntero al objeto de región de operación que crea el controlador ACPI para la región de operación.

Valor devuelto

Devuelve uno de los siguientes valores de estado:

Código devuelto Descripción
STATUS_SUCCESS El controlador de región operativa se registró correctamente.
STATUS_ACPI_INVALID_DATA La información especificada no es válida.
STATUS_INSUFFICIENT_RESOURCES La rutina no pudo asignar los recursos del sistema necesarios.
STATUS_Xxx Error interno.

Observaciones

El contexto de la región de operación especificado por context es específico del dispositivo y solo lo usa el controlador de función. Normalmente, el contexto es la extensión del dispositivo para el objeto de dispositivo funcional (FDO) . El controlador ACPI vuelve a pasar este contexto al controlador de función cuando llama al controlador de región de operación. El objeto de región de operación solo lo usa un controlador de función para identificar de forma única la región de la operación cuando anula el registro del controlador de región de la operación.

Para obtener más información sobre las regiones de operación, consulte Compatibilidad con una región de operación.

Requisitos

Requisito Valor
de la plataforma de destino de Universal
encabezado de oprghdlr.h (incluya Oprghdlr.h)
biblioteca de Oprghdlr.lib
irQL PASSIVE_LEVEL

Consulte también

ACPI_OP_REGION_HANDLER

deRegisterOpRegionHandler

  • Last updated on