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

Uma rotina tipo ACPI_OP_REGION_HANDLER é fornecida por um driver de função do 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 de operação. Dependendo do tipo de acesso, os dados são transferidos para ou desse 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.

Valor retornado

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 alocado 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 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 (Configuração Avançada e Interface de Energia).

Requisitos

   
Plataforma de Destino Desktop
Cabeçalho oprghdlr.h (include Oprghdlr.h)

Confira também

DeRegisterOpRegionHandler