Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
La routine RegisterOpRegionHandler registra un gestore dell'area dell'operazione con il driver ACPI .
Sintassi
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
);
Parametri
[in] DeviceObject
Puntatore al dell'oggetto dispositivo fisico (PDO) che rappresenta il dispositivo ACPI che definisce l'area dell'operazione.
[in] AccessType
Specifica ACPI_OPREGION_ACCESS_AS_COOKED.
[in] RegionSpace
Specifica uno dei tipi di spazio dell'area seguenti.
| Identificatore dello spazio dell'area | Descrizione |
|---|---|
| ACPI_OPREGION_REGION_SPACE_MEMORY | Memoria di sistema |
| ACPI_OPREGION_REGION_SPACE_IO | Spazio di I/O |
| ACPI_OPREGION_REGION_SPACE_PCI_CONFIG | Configurazione pci |
| ACPI_OPREGION_REGION_SPACE_EC | Controller incorporato |
| ACPI_OPREGION_REGION_SPACE_SMB | Bus di gestione del sistema |
| ACPI_OPREGION_REGION_SPACE_CMOS_CONFIG | Configurazione DI GESTIONE |
| ACPI_OPREGION_REGION_SPACE_PCIBARTARGET | Registro degli indirizzi di base PCI |
| Valore definito dal fornitore da 0x80 a 0xFF | Definito dal fornitore |
[in] Handler
Puntatore al gestore dell'area dell'operazione ACPI_OP_REGION_HANDLERtipizzata (fornito da un driver di funzione del dispositivo ACPI).
[in] Context
Puntatore a un contesto dell'area operativa specifica del dispositivo (fornito da un driver di funzione del dispositivo ACPI).
[in] Flags
Riservato per uso interno.
[out] OperationRegionObject
Puntatore al buffer allocato dal chiamante che, nell'output, contiene un puntatore all'oggetto area dell'operazione creato dal driver ACPI per l'area dell'operazione.
Valore restituito
Restituisce uno dei valori di stato seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | Il gestore dell'area operativa è stato registrato correttamente. |
| STATUS_ACPI_INVALID_DATA | Le informazioni specificate non sono valide. |
| STATUS_INSUFFICIENT_RESOURCES | Impossibile allocare le risorse di sistema necessarie. |
| STATUS_Xxx | Si è verificato un errore interno. |
Osservazioni
Il contesto dell'area dell'operazione specificato da Context è specifico del dispositivo e viene usato solo dal driver di funzione. In genere, il contesto è l'estensione del dispositivo per l'oggetto dispositivo funzionale (FDO). Il driver ACPI passa nuovamente questo contesto al driver di funzione quando chiama il gestore dell'area dell'operazione. L'oggetto area dell'operazione viene usato solo da un driver di funzione per identificare in modo univoco l'area dell'operazione quando annulla la registrazione del gestore dell'area dell'operazione.
Per altre informazioni sulle aree operative, vedere Supporto di un'area operativa.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | oprghdlr.h (include Oprghdlr.h) |
| libreria | Oprghdlr.lib |
| IRQL | PASSIVE_LEVEL |