ACPI_OP_REGION_HANDLER función de devolución de llamada (oprghdlr.h)
Un controlador de función de dispositivo ACPI proporciona una rutina ACPI_OP_REGION_HANDLER tipada para proporcionar acceso al controlador ACPI a la región de operación del dispositivo.
Sintaxis
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
)
{...}
Parámetros
AccessType
Especifica uno de los siguientes tipos de acceso:
| Tipo de acceso | Descripción |
|---|---|
| ACPI_OPREGION_WRITE | Escriba en el búfer de memoria de la región de la operación. |
| ACPI_OPREGION_READ | Lee desde el búfer de memoria de la región de la operación. |
OperationRegionObject
Especifica el objeto de región de operación devuelto por RegisterOpRegionHandler para el controlador de región de la operación.
Address
Especifica un desplazamiento de bytes en el búfer de memoria de la región de la operación. En función del tipo de acceso, los datos se transfieren a esta ubicación de memoria o desde esta ubicación de memoria.
Size
Especifica el número de bytes a los que se va a acceder.
Data
Puntero al búfer de datos proporcionado por el controlador ACPI asociado al acceso. Para un acceso de lectura, los bytes se transfieren desde el búfer de memoria de la región de la operación al búfer de datos. Para un acceso de escritura, los bytes se transfieren desde el búfer de datos al búfer de memoria de la región de la operación.
Context
Puntero al mismo contexto de región de operación que el controlador de función especificó cuando registró el controlador de región de operación.
CompletionHandler
Reservado para uso interno.
CompletionContext
Reservado para uso interno.
Valor devuelto
Devuelve uno de los siguientes valores de estado:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | El acceso se realizó correctamente. |
| STATUS_INVALID_DEVICE_REQUEST | El tipo de acceso no es válido. |
| STATUS_Xxx | Error interno. |
Observaciones
Cuando el controlador ACPI llama a un controlador de región de operación, especifica los valores de Address y Size que garantizan que el acceso está dentro de la región de operación definida en el BIOS ACPI para el dispositivo ACPI. El controlador de función del dispositivo ACPI debe asegurarse de que el búfer de memoria de la región de operación que asigna sea al menos tan grande, en bytes, como la región de operación definida para el dispositivo ACPI.
Para obtener más información sobre los controladores de región de operación, consulte Compatibilidad con una región de operación.
Una rutina con tipo ACPI_OP_REGION_HANDLER se ejecuta en irQL del autor de la llamada.
Para obtener información detallada sobre las restricciones en las regiones de operación, consulte la especificación de Advanced Configuration and Power Interface (ACPI).
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | oprghdlr.h (incluya Oprghdlr.h) |