ACPI_OP_REGION_HANDLER funzione di callback (oprghdlr.h)

Una routine tipizzata ACPI_OP_REGION_HANDLER viene fornita da un driver di funzioni del dispositivo ACPI per fornire l'accesso dal driver ACPI all'area operativa del dispositivo.

Sintassi

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

Parametri

AccessType

Specifica uno dei tipi di accesso seguenti:

Tipo di accesso	Descrizione
ACPI_OPREGION_WRITE	Scrivere nel buffer di memoria dell'area dell'operazione.
ACPI_OPREGION_READ	Leggere dal buffer di memoria dell'area dell'operazione.

OperationRegionObject

Specifica l'oggetto area dell'operazione restituito da RegisterOpRegionHandler per il gestore dell'area dell'operazione.

Address

Specifica un offset di byte nel buffer di memoria dell'area dell'operazione. A seconda del tipo di accesso, i dati vengono trasferiti da o verso questa posizione di memoria.

Size

Specifica il numero di byte a cui accedere.

Data

Puntatore al buffer di dati fornito dal driver ACPI associato all'accesso. Per un accesso in lettura, i byte vengono trasferiti dal buffer di memoria dell'area dell'operazione al buffer dei dati. Per un accesso in scrittura, i byte vengono trasferiti dal buffer dei dati al buffer di memoria dell'area dell'operazione.

Context

Puntatore allo stesso contesto dell'area dell'operazione specificato dal driver di funzione quando ha registrato il gestore dell'area dell'operazione.

CompletionHandler

Riservato per utilizzo interno.

CompletionContext

Riservato per utilizzo interno.

Valore restituito

Restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	L'accesso è riuscito.
STATUS_INVALID_DEVICE_REQUEST	Il tipo di accesso non è valido.
STATUS_Xxx	An internal error occurred.

Commenti

Quando il driver ACPI chiama un gestore dell'area operativa, specifica i valori per Address e Size che assicurano che l'accesso si trova all'interno dell'area operativa definita nel BIOS ACPI per il dispositivo ACPI. Il driver di funzione del dispositivo ACPI deve garantire che il buffer di memoria dell'area dell'operazione allocato sia almeno di grandi dimensioni, in byte, come l'area operativa definita per il dispositivo ACPI.

Per altre informazioni sui gestori dell'area operativa, vedere Supporto di un'area operativa.

Una routine tipizzata ACPI_OP_REGION_HANDLER viene eseguita nel runtime irQL del chiamante.

Per informazioni dettagliate sui vincoli sulle aree operative, vedere La specifica ACPI (Advanced Configuration and Power Interface).

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	oprghdlr.h (include Oprghdlr.h)

Vedi anche

DeRegisterOpRegionHandler