Función KeQueryDpcWatchdogInformation (wdm.h)
La rutina KeQueryDpcWatchdogInformation devuelve los valores del temporizador de temporizador de llamada a procedimiento diferido (DPC) para el procesador actual.
Sintaxis
NTSTATUS KeQueryDpcWatchdogInformation(
[out] PKDPC_WATCHDOG_INFORMATION WatchdogInformation
);
Parámetros
[out] WatchdogInformation
Puntero a una estructura de KDPC_WATCHDOG_INFORMATION proporcionada por el autor de la llamada. La rutina escribe los valores actuales del temporizador del guardián de DPC en esta estructura.
Valor devuelto
KeQueryDpcWatchdogInformation devuelve un valor NTSTATUS. Los valores devueltos posibles incluyen los siguientes códigos de estado.
| Código devuelto | Descripción |
|---|---|
|
Se llamó a KeQueryDpcWatchdogInformation mientras se ejecutaba un DPC en el procesador actual. |
|
El procesador actual no estaba ejecutando un DPC cuando se llamó a KeQueryDpcWatchdogInformation . |
Comentarios
Se puede llamar a la rutina KeQueryDpcWatchdogInformation desde una rutina DPC o en un IRQL= DISPATCH_LEVEL para determinar la cantidad de tiempo que permanece antes de que se produzca un tiempo de espera de DPC. El sistema operativo implementa un temporizador de guardián DPC para detectar cuándo se ejecuta una sola rutina DPC durante demasiado tiempo o cuando una serie de rutinas DPC en cola se vuelven a ejecutar durante demasiado tiempo. Si se habilitan errores de tiempo de espera de DPC y si una rutina de DPC supera el límite de tiempo de una sola rutina, o una serie de rutinas DPC supera el límite de tiempo agregado, se produce una comprobación de errores de DPC_WATCHDOG_VIOLATION (0x133 ).
Se debe llamar a KeQueryDpcWatchdogInformation mientras se ejecuta o se invoca un DPC en un IRQL= DISPATCH_LEVEL o superior en el procesador actual. De lo contrario, se produce un error en la llamada y se devuelve STATUS_UNSUCCESSFUL.
Las rutinas DPC solo se deben ejecutar durante breves períodos y deben delegar tanto procesamiento como sea posible para los subprocesos de trabajo. Para evitar degradar la capacidad de respuesta del sistema, se debe ejecutar una rutina de DPC típica para no más de 100 microsegundos cada vez que se llama. Para obtener más información, vea Directrices para escribir rutinas DPC.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows Vista. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | DISPATCH_LEVEL |