Función KeSetImportanceDpc (wdm.h)

Artículo
02/27/2024

La rutina KeSetImportanceDpc especifica la próxima vez que se ejecuta la rutina DPC.

Sintaxis

void KeSetImportanceDpc(
  [in, out] PRKDPC          Dpc,
  [in]      KDPC_IMPORTANCE Importance
);

Parámetros

[in, out] Dpc

Puntero al objeto DPC del autor de la llamada, que KeInitializeDpc ya inicializó.

[in] Importance

Especifica uno de los siguientes valores definidos por el sistema para determinar el comportamiento de KeInsertQueueDpc e IoRequestDpc cuando se usa cualquiera de las rutinas para poner en cola el DPC.

LowImportance

Coloque el DPC al final de la cola DPC y no comience el procesamiento de la cola.

MediumImportance

Coloque el DPC al final de la cola DPC. Si el DPC se asigna a la cola DPC del procesador actual, comience a procesar la cola inmediatamente. MediumImportance es el valor predeterminado de Importance.

MediumHighImportance

Coloque el DPC al final de la cola DPC y comience a procesar la cola inmediatamente. MediumHighImportance solo está disponible en Windows Vista y versiones posteriores de Windows.

HighImportance

Coloque el DPC al principio de la cola DPC y comience a procesar la cola inmediatamente.

Valor devuelto

None

Observaciones

La rutina KeSetImportanceDpc influye en la breve ejecución de un DPC después de ponerla en cola mediante la determinación de:

Ubicación del DPC dentro de la cola DPC. Normalmente, las rutinas KeInsertQueueDpc e IoRequestDpc colocan un DPC al final de la cola. Si un controlador llama primero a KeSetImportanceDpc con Importance = HighImportance, KeInsertQueueDpc e IoRequestDpc colocarán el DPC al principio de la cola.
Cuando el sistema comienza a procesar la cola DPC. Normalmente, KeInsertQueueDpc e IoRequestDpc comienzan inmediatamente a procesar la cola DPC para el procesador actual. Los controladores pueden especificar valores diferentes para que Importance cambie este comportamiento.

De forma predeterminada, los DPC se asignan a la cola DPC para el procesador actual, por lo que especificar MediumImportance o MediumHighImportance for Importance tiene el mismo efecto. Sin embargo, los controladores pueden usar KeSetTargetProcessorDpc para cambiar el procesador al que se asignará el DPC.

Para Windows Vista y versiones posteriores del sistema operativo Windows, puedes usar KeSetImportanceDpc para DPC subprocesos. Si el autor de la llamada establece Importance en HighImportance, el DPC se coloca al principio de la cola; de lo contrario, se coloca al final. La rutina no afecta cuando se procesa la cola de DPC en subproceso. Los DPC subprocesos siempre se procesan mediante un subproceso dedicado en IRQL = PASSIVE_LEVEL. Para obtener más información sobre los DPC con subprocesos, vea Introducción a los DPC con subprocesos.

Tenga en cuenta que un controlador debe llamar a KeSetImportanceDpc antes de llamar a KeInsertQueueDpc e IoRequestDpc para tener cualquier efecto.

Para obtener más información sobre cómo procesa el sistema la cola DPC, consulte Organización de colas de DPC.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 2000.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	Cualquier nivel