Implementazione di un gestore dell'area operativa

Il driver deve fornire un gestore dell'area operativa, cioè un callback PACPI_OP_REGION_HANDLER tipizzato. Il driver ACPI chiama il gestore operazioni per accedere ai campi dati nell'area operativa del driver. L'operazione combinata del driver di funzione e del BIOS ACPI è definita dal fornitore e specifica del dispositivo. In generale, il driver di funzione e il BIOS ACPI accedono in un'area operativa che comportano operazioni specifiche del dispositivo e restituiscono le informazioni appropriate.

Un gestore dell'area operativa usa in genere i parametri seguenti che il driver ACPI passa al gestore:

• AccessType specifica se l'accesso è di lettura o scrittura.

  Se l'accesso è in lettura, i dati vengono trasferiti dal buffer di memoria dell'area operativa al buffer di dati . Se l'accesso è una scrittura, i dati vengono trasferiti dal buffer di dati al buffer di memoria dell'area operativa. Vedere Accesso a un'area operativa.

• Address specifica un offset in byte nel buffer di memoria della regione operativa.

• Size specifica il numero di byte da trasferire.

• I dati specificano un buffer fornito dal driver ACPI per il trasferimento dei dati.

• Context specifica il contesto dell'area operativa registrato dal driver per il gestore dell'area dell'operazione.

  Il contesto dell'area operativa viene usato solo dal driver di funzione ed è specifico del dispositivo.

Oltre ai parametri descritti in precedenza, il driver ACPI passa al gestore dell'area operativa anche i puntatori ai seguenti elementi: un oggetto area operativa, un gestore di completamento e un contesto di completamento. Tuttavia, il driver della funzione non utilizza l'oggetto regione operativa in un gestore, e il gestore di completamento e il contesto sono riservati per uso interno.