Função RegisterOpRegionHandler (oprghdlr.h)

  • Artigo

A rotina RegisterOpRegionHandler registra um manipulador de região de operação com o driver ACPI.

Sintaxe

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

Ponteiro para o PDO (objeto de dispositivo físico) que representa o dispositivo ACPI que define a região da operação.

[in] AccessType

Especifica ACPI_OPREGION_ACCESS_AS_COOKED.

[in] RegionSpace

Especifica um dos seguintes tipos de espaço na região.

Identificador de espaço de região Descrição
ACPI_OPREGION_REGION_SPACE_MEMORY Memória do sistema
ACPI_OPREGION_REGION_SPACE_IO Espaço de E/S
ACPI_OPREGION_REGION_SPACE_PCI_CONFIG Configuração de PCI
ACPI_OPREGION_REGION_SPACE_EC Controlador inserido
ACPI_OPREGION_REGION_SPACE_SMB Barramento de gerenciamento do sistema
ACPI_OPREGION_REGION_SPACE_CMOS_CONFIG Configuração do CMOS
ACPI_OPREGION_REGION_SPACE_PCIBARTARGET Registro de endereço base PCI
Valor definido pelo fornecedor de 0x80 para 0xFF Definido pelo fornecedor

[in] Handler

Ponteiro para o manipulador de região de operação do tipo ACPI_OP_REGION_HANDLER (fornecido por um driver de função de dispositivo ACPI).

[in] Context

Ponteiro para um contexto de região de operação específico do dispositivo (fornecido por um driver de função de dispositivo ACPI).

[in] Flags

Reservado para uso interno.

[out] OperationRegionObject

Ponteiro para o buffer alocado pelo chamador que, na saída, contém um ponteiro para o objeto de região de operação que o driver ACPI cria para a região da operação.

Retornar valor

Retorna um dos seguintes valores de status:

Código de retorno Descrição
STATUS_SUCCESS O manipulador de região operacional foi registrado com êxito.
STATUS_ACPI_INVALID_DATA As informações especificadas não são válidas.
STATUS_INSUFFICIENT_RESOURCES A rotina não pôde alocar os recursos necessários do sistema.
STATUS_Xxx Ocorreu um erro interno.

Comentários

O contexto da região de operação especificado por Context é específico do dispositivo e é usado apenas pelo driver de função. Normalmente, o contexto é a extensão de dispositivo para o FDO (objeto de dispositivo funcional). O driver ACPI passa esse contexto de volta para o driver de função quando chama o manipulador de região de operação. O objeto de região de operação só é usado por um driver de função para identificar exclusivamente a região da operação quando ele desregistro do manipulador de região de operação.

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

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho oprghdlr.h (inclua Oprghdlr.h)
Biblioteca Oprghdlr.lib
IRQL PASSIVE_LEVEL

Confira também

ACPI_OP_REGION_HANDLER

DeRegisterOpRegionHandler