Función NdisMQueueDpc (ndis.h)

Los controladores de minipuerto de NDIS llaman a la función NdisMQueueDpc para programar llamadas DPC en CPU.

Sintaxis

ULONG NdisMQueueDpc(
  [in]           NDIS_HANDLE NdisInterruptHandle,
  [in]           ULONG       MessageId,
  [in]           ULONG       TargetProcessors,
  [in, optional] PVOID       MiniportDpcContext
);

Parámetros

[in] NdisInterruptHandle

Identificador de interrupción que el controlador de minipuerto obtuvo en una llamada anterior a . Función NdisMRegisterInterruptEx .

[in] MessageId

Identificador de mensaje MSI para DPC. Si el DPC es para una interrupción basada en línea, este parámetro no se usa y debe establecerse en cero. De lo contrario, MessageId es un índice de IO_INTERRUPT_MESSAGE_INFO_ENTRY estructuras dentro de IO_INTERRUPT_MESSAGE_INFO estructura. NDIS pasa un puntero a la estructura de IO_INTERRUPT_MESSAGE_INFO asociada en el miembro MessageInfoTable cuando el controlador se registra correctamente para MSI con la función NdisMRegisterInterruptEx .

[in] TargetProcessors

Mapa de bits que indica los procesadores de destino para los que NDIS debe programar un DPC. Cada bit de TargetProcessors identifica una CPU. Si el autor de la llamada establece el bit 0, NDIS programa un DPC para la CPU 0. Si el autor de la llamada establece el bit 1, NDIS programa un DPC para la CPU 1, etc.

[in, optional] MiniportDpcContext

Puntero a un área de contexto especificada por el autor de la llamada. NDIS pasa este puntero al parámetro MiniportDpcContext del MiniportInterruptDPC y Funciones MiniportMessageInterruptDPC .

Valor devuelto

NdisMQueueDpc devuelve un mapa de bits que indica los procesadores de destino para los que NDIS programó correctamente un DPC. Cada bit del valor devuelto identifica una CPU. Si NDIS establece el bit 0, NDIS programó un DPC para la CPU 0. Si NDIS establece el bit 1, NDIS programó un DPC para la CPU 1, etc.

Si el controlador solicitó un DPC para una CPU y NDIS indica que no programó ese DPC, el DPC no estaba programado porque ya estaba programado un DPC para esa CPU.

Comentarios

NDIS llama a MiniportInterruptDPC o MiniportMessageInterruptDPC para completar el procesamiento diferido de una interrupción. El controlador de minipuerto puede llamar a NdisMQueueDpc para solicitar llamadas DPC adicionales para otros procesadores.

Requisitos

Requisito	Value
Cliente mínimo compatible	Se admite en NDIS 6.0 y 6.1. Para NDIS 6.20 y versiones posteriores, use NdisMQueueDpcEx.
Plataforma de destino	Universal
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	Cualquier nivel

Consulte también

MiniportInterruptDPC

MiniportMessageInterruptDPC

NdisMQueueDpcEx

NdisMRegisterInterruptEx