Función de devolución de llamada POFXCALLBACKENUMERATEUNMASKEDINTERRUPTS (pep_x.h)
La EnumerateUnmaskedInterrupts rutina enumera los 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 en la plataforma de hardware que están sin máscara 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. Esta rutina de devolución de llamada se llama una vez para cada origen de interrupción cuya interrupción está sin máscara. Estas devoluciones de llamada se producen sincrónicamente antes de que se devuelva la rutina EnumerateUnmaskedInterrupts.
[in] CallbackContext
Puntero a un contexto de devolución de llamada. Este puntero se pasa como parámetro a la EnumerateInterruptSource rutina de devolución de llamada a la que apunta el parámetro callback. El contenido del contexto de devolución de llamada está definido por PEP y es opaco con 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 tamaño de(PEP_UNMASKED_INTERRUPT_INFORMATION) bytes. EnumerateUnmaskedInterrupts usará este búfer para transferir información de interrupción al PEP durante las llamadas al EnumerateInterruptSource de pep rutina de devolución de llamada.
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 |
|---|---|
|
El miembro Size o Version de la estructura PEP_UNMASKED_INTERRUPT_INFORMATION contiene un valor no válido. |
Observaciones
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 | Valor |
|---|---|
| cliente mínimo admitido | Se admite a partir de Windows 10. |
| de la plataforma de destino de | Windows |
| encabezado de | pep_x.h (incluya Pep_x.h) |
| irQL | <= HIGH_LEVEL |