Función PshedSynchronizeExecution (ntddk.h)
La función PshedSynchronizeExecution sincroniza la ejecución de una función determinada con el procesamiento de errores de hardware para un origen de error.
Sintaxis
NTPSHEDAPI BOOLEAN PshedSynchronizeExecution(
[in] PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource,
[in] PKSYNCHRONIZE_ROUTINE SynchronizeRoutine,
[in] PVOID SynchronizeContext
);
Parámetros
[in] ErrorSource
Puntero a una estructura WHEA_ERROR_SOURCE_DESCRIPTOR que describe un origen de error.
[in] SynchronizeRoutine
Puntero a una función proporcionada por el autor de la llamada cuya ejecución se sincroniza con el procesamiento de errores de hardware para el origen de errores descrito por el parámetro ErrorSource. Se declara una función SynchronizeRoutine de la siguiente manera:
BOOLEAN
SynchronizeRoutine(
_In_ PVOID SynchronizeContext
);
SynchronizeContext
Valor de contexto que se pasa en el parámetro SynchronizeContext a la función PshedSynchronizeExecution.
[in] SynchronizeContext
Puntero a un área de contexto proporcionada por el autor de la llamada que se pasa a la función a la que apunta el parámetro SynchronizeRoutine.
Valor devuelto
pshedSynchronizeExecution devuelve el valor devuelto por la función a la que apunta el parámetro SynchronizeRoutine.
Observaciones
Un complemento PSHED llama a la función PshedSynchronizeExecution para sincronizar la ejecución de una función determinada con el procesamiento de errores de hardware para un origen de error. Esto es necesario siempre que un complemento PSHED comparte recursos entre el código que se ejecuta fuera del flujo de procesamiento de errores de hardware normal y el código que se ejecuta como parte del flujo de procesamiento de errores de hardware normal. Para obtener más información sobre el procesamiento de errores de hardware, consulte Error Processing.
Cuando se llama a esta función, se produce lo siguiente:
IRQL se genera en IRQL en el que se ejecuta el controlador de errores de hardware de bajo nivel (LLHEH) para el origen de errores.
El acceso al área de contexto especificada por el parámetro SynchronizeContext se sincroniza con el LLHEH mediante la adquisición del bloqueo de número asociado.
Se llama a la función especificada en el parámetro SynchronizeRoutine.
Los autores de llamadas de la función pshedSynchronizeExecution de deben ejecutarse en IRQL <= DIRQL, es decir, menor o igual que el IRQL en el que se ejecuta el LLHEH para el origen de errores.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | ntddk.h (incluya Ntddk.h) |
| biblioteca de | Pshed.lib |
| DLL de | Pshed.dll |
| irQL | IRQL <= DIRQL |