Registrazione e registrazione di un gestore dell'area operazione

Un driver di funzione del dispositivo ACPI registra un gestore dell'area operativa chiamando RegisterOpRegionHandler e fornendo le informazioni seguenti:

• Oggetto dispositivo fisico (PDO) che rappresenta il dispositivo ACPI che definisce l'area dell'operazione.

• Tipo di accesso, che può essere crudo o cucinato.

  Per altre informazioni, vedere Accesso a un'area operativa

• Tipo di spazio dell'area.

  Il fornitore deve specificare un valore definito dal fornitore da 0x80 a 0xFF. I valori inferiori a 0x80 sono definiti dalla specifica ACPI e sono riservati per l'uso interno.

• Puntatore al gestore dell'area operativa del driver.

  Il driver ACPI accede a un'area operativa chiamando il gestore dell'area operativa del driver.

• Puntatore al contesto dell'area dell'operazione.

  Il contesto dell'area operativa è specifico del dispositivo e viene usato solo dal driver di funzione. Quando il driver ACPI chiama il gestore dell'area operativa, passa nuovamente il contesto dell'area dell'operazione al gestore. In genere, è l'estensione del dispositivo dell'oggetto dispositivo funzionale (FDO).

RegisterOpRegionHandler restituisce un oggetto area dell'operazione usato dal driver di funzione per identificare in modo univoco il gestore dell'area dell'operazione solo quando il driver deregista il gestore.

In genere, un driver registra un gestore dell'area operativa nella routine di invio Plug and Play driver dopo l'avvio di un oggetto FDO in risposta a una richiesta di IRP_MN_START_DEVICE. Il driver deve registrare il gestore dopo aver allocato il contesto dell'area dell'operazione del gestore. Se il driver crea un'interfaccia del dispositivo definita dal fornitore, il driver deve abilitare l'interfaccia del dispositivo dopo aver registrato il gestore.

Un driver di funzione del dispositivo ACPI deregista un gestore dell'area operativa chiamando DeRegisterOpRegionHandler e fornendo le informazioni seguenti:

• PDO che rappresenta il dispositivo ACPI che definisce l'area dell'operazione.

• Oggetto area operazione restituito dal driver ACPI quando il driver ha registrato il gestore dell'area dell'operazione. Questo oggetto identifica in modo univoco il gestore dell'area dell'operazione.

In genere, un driver deregista un gestore dell'area operativa nella routine di invio Plug and Play driver prima di arrestare un oggetto FDO in risposta a una richiesta di IRP_MN_STOP_DEVICE. Il driver deve annullare la registrazione del gestore prima di liberare il contesto dell'area operativa del gestore. Se il driver crea un'interfaccia del dispositivo definita dal fornitore, il driver deve disabilitare l'interfaccia del dispositivo prima che deregista il gestore.