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 |