Compartir a través de

ACPI_OP_REGION_HANDLER función de devolución de llamada (oprghdlr.h)

  • Artículo

Un controlador de función de dispositivo ACPI proporciona una rutina de tipo ACPI_OP_REGION_HANDLER para proporcionar acceso por parte del controlador ACPI a la región de operación del dispositivo.

Sintaxis

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
)
{...}

Parámetros

AccessType

Especifica uno de los siguientes tipos de acceso:

Tipo de acceso Descripción
ACPI_OPREGION_WRITE Escriba en el búfer de memoria de la región de la operación.
ACPI_OPREGION_READ Lee desde el búfer de memoria de la región de la operación.

OperationRegionObject

Especifica el objeto de región de operación devuelto por RegisterOpRegionHandler para el controlador de región de la operación.

Address

Especifica un desplazamiento de bytes en el búfer de memoria de la región de operación. Según el tipo de acceso, los datos se transfieren a esta ubicación de memoria o desde esta ubicación de memoria.

Size

Especifica el número de bytes a los que se va a acceder.

Data

Puntero al búfer de datos proporcionado por el controlador ACPI asociado al acceso. Para un acceso de lectura, los bytes se transfieren desde el búfer de memoria de la región de operación al búfer de datos. Para un acceso de escritura, los bytes se transfieren desde el búfer de datos al búfer de memoria de la región de operación.

Context

Puntero al mismo contexto de la región de operación que el controlador de función especificó cuando registró el controlador de la región de la operación.

CompletionHandler

Reservado para uso interno.

CompletionContext

Reservado para uso interno.

Valor devuelto

Devuelve uno de los siguientes valores de estado:

Código devuelto Descripción
STATUS_SUCCESS El acceso se realizó correctamente.
STATUS_INVALID_DEVICE_REQUEST El tipo de acceso no es válido.
STATUS_Xxx Se ha producido un error interno.

Comentarios

Cuando el controlador ACPI llama a un controlador de región de operación, especifica valores para Address y Size que garantizan que el acceso está dentro de la región de operación definida en el BIOS ACPI para el dispositivo ACPI. El controlador de función del dispositivo ACPI debe asegurarse de que el búfer de memoria de la región de operación que asigna sea al menos tan grande, en bytes, como la región de operación definida para el dispositivo ACPI.

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

Una rutina con tipo ACPI_OP_REGION_HANDLER se ejecuta en el IRQL del autor de la llamada.

Para obtener información detallada sobre las restricciones en las regiones de operación, consulte la especificación advanced configuration and Power Interface (ACPI).

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado oprghdlr.h (include Oprghdlr.h)

Consulte también

DeRegisterOpRegionHandler