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) |