Compartir a través de

Función de devolución de llamada POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS (pep_x.h)

  • Artículo

La rutina EnumerateUnmaskedInterrupts enumera orígenes de interrupción cuyas interrupciones están sin máscara y habilitadas.

Sintaxis

POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS Pofxcallbackenumerateunmaskedinterrupts;

NTSTATUS Pofxcallbackenumerateunmaskedinterrupts(
  [in, optional] POHANDLE PluginHandle,
  [in, optional] ULONG EnumerateFlags,
  [in]           PPO_ENUMERATE_INTERRUPT_SOURCE_CALLBACK Callback,
  [in]           PVOID CallbackContext,
  [in, out]      PPEP_UNMASKED_INTERRUPT_INFORMATION InterruptInformation
)
{...}

Parámetros

[in, optional] PluginHandle

Valor POHANDLE. Si no es NULL, este parámetro es un identificador que identifica el complemento de extensión de plataforma (PEP), en cuyo caso EnumerateUnmaskedInterrupts enumera solo las interrupciones administradas por este PEP. Si este parámetro es NULL, EnumerateUnmaskedInterrupts enumera todas las interrupciones de la plataforma de hardware que no están enmascaradas y habilitadas.

[in, optional] EnumerateFlags

Actualmente no hay marcas definidas. Establezca este parámetro en PEP_ENUMERATE_UNMASKED_INTERRUPT_FLAGS_NONE (0x0).

[in] Callback

Puntero a una rutina de devolución de llamada implementada por el autor de la llamada EnumerateInterruptSource . Se llama a esta rutina de devolución de llamada una vez para cada origen de interrupción cuya interrupción no está enmascarada. Estas devoluciones de llamada se producen de forma sincrónica antes de que se devuelva la rutina EnumerateUnmaskedInterrupts .

[in] CallbackContext

Puntero a un contexto de devolución de llamada. Este puntero se pasa como un parámetro a la rutina de devolución de llamada EnumerateInterruptSource a la que apunta el parámetro Callback . El contenido del contexto de devolución de llamada está definido por PEP y es opaco para el marco de administración de energía (PoFx).

[in, out] InterruptInformation

Puntero a un búfer asignado por el autor de la llamada cuyo tamaño es al menos sizeof(PEP_UNMASKED_INTERRUPT_INFORMATION) bytes. EnumerateUnmaskedInterrupts usará este búfer para transferir información de interrupción al PEP durante las llamadas a la rutina de devolución de llamada EnumerateInterruptSource del PEP.

Valor devuelto

EnumerateUnmaskedInterrupts devuelve STATUS_SUCCESS si la llamada enumera correctamente las interrupciones. Entre los posibles valores devueltos de error se incluyen el siguiente código de estado.

Valor devuelto Descripción
STATUS_INVALID_PARAMETER
 El miembro Size o Version de la estructura PEP_UNMASKED_INTERRUPT_INFORMATION contiene un valor no válido.

Comentarios

PoFx implementa esta rutina y la llama el PEP. El miembro EnumerateUnmaskedInterrupts de la estructura PEP_KERNEL_INFORMATION_STRUCT_V3 es un puntero a una rutina EnumerateUnmaskedInterrupts .

Antes de que la plataforma entre en un estado de alimentación del sistema en el que los controladores de interrupción están cerrados, el PEP puede llamar a EnumerateUnmaskedInterrupts para obtener la información que necesita para configurar correctamente los controladores de reactivación para las interrupciones que deben permanecer sin máscara.

El PEP puede llamar a esta rutina en IRQL <= HIGH_LEVEL.

Requisitos

Requisito Value
Cliente mínimo compatible Se admite a partir de Windows 10.
Plataforma de destino Windows
Encabezado pep_x.h (incluya Pep_x.h)
IRQL <= HIGH_LEVEL

Consulte también

EnumerateInterruptSource

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_UNMASKED_INTERRUPT_INFORMATION