ACPI_OP_REGION_HANDLER função de retorno de chamada (oprghdlr.h)

  • Artigo

Uma rotina do tipo ACPI_OP_REGION_HANDLER é fornecida por um driver de função de dispositivo ACPI para fornecer acesso pelo driver ACPI à região de operação do dispositivo.

Sintaxe

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 um dos seguintes tipos de acesso:

Tipo de acesso Descrição
ACPI_OPREGION_WRITE Gravar no buffer de memória da região de operação.
ACPI_OPREGION_READ Leitura do buffer de memória da região de operação.

OperationRegionObject

Especifica o objeto de região de operação retornado por RegisterOpRegionHandler para o manipulador de região de operação.

Address

Especifica um deslocamento de bytes no buffer de memória da região da operação. Dependendo do tipo de acesso, os dados são transferidos de ou para esse local de memória.

Size

Especifica o número de bytes a serem acessados.

Data

Ponteiro para o buffer de dados fornecido pelo driver ACPI associado ao acesso. Para um acesso de leitura, os bytes são transferidos do buffer de memória da região de operação para o buffer de dados. Para um acesso de gravação, os bytes são transferidos do buffer de dados para o buffer de memória da região de operação.

Context

Ponteiro para o mesmo contexto de região de operação que o driver de função especificou quando registrou o manipulador de região de operação.

CompletionHandler

Reservado para uso interno.

CompletionContext

Reservado para uso interno.

Retornar valor

Retorna um dos seguintes valores de status:

Código de retorno Descrição
STATUS_SUCCESS O acesso foi bem-sucedido.
STATUS_INVALID_DEVICE_REQUEST O tipo de acesso é inválido.
STATUS_Xxx Ocorreu um erro interno.

Comentários

Quando o driver ACPI chama um manipulador de região de operação, ele especifica valores para Endereço e Tamanho que garantem que o acesso esteja dentro da região de operação definida no ACPI BIOS para o dispositivo ACPI. O driver de função do dispositivo ACPI deve garantir que o buffer de memória da região de operação que ele aloca seja pelo menos tão grande, em bytes, quanto a região de operação definida para o dispositivo ACPI.

Para obter mais informações sobre manipuladores de região de operação, consulte Suporte a uma região de operação.

Uma rotina do tipo ACPI_OP_REGION_HANDLER é executada no IRQL do chamador.

Para obter informações detalhadas sobre restrições em regiões de operação, consulte a Especificação de ACPI (Advanced Configuration and Power Interface).

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho oprghdlr.h (inclua Oprghdlr.h)

Confira também

DeRegisterOpRegionHandler