EVT_PACKET_QUEUE_STOP función de devolución de llamada (netpacketqueue.h)

Artículo
05/23/2024

La función de devolución de llamada EvtPacketQueueStop es una devolución de llamada opcional implementada por el controlador cliente para detener la ruta de acceso de datos de una cola de paquetes.

Sintaxis

EVT_PACKET_QUEUE_STOP EvtPacketQueueStop;

void EvtPacketQueueStop(
  [_In_] NETPACKETQUEUE PacketQueue
)
{...}

Parámetros

[_In_] PacketQueue

Identificador de una cola de paquetes.

Valor devuelto

None

Observaciones

Se trata de una devolución de llamada opcional. Registre esta función de devolución de llamada en la devolución de llamada EVT_NET_ADAPTER_CREATE_TX(rxQueueContext)QUEUE . Establezca el miembro adecuado de una estructura de NET_PACKET_QUEUE_CONFIG después de inicializar la estructura con NET_PACKET_QUEUE_CONFIG_INIT y, a continuación, llame a NetTx(rxQueueContext)QueueCreate.

Esta devolución de llamada no devuelve un valor y, por lo tanto, no debe producir un error, por lo que esta devolución de llamada debe ser una función ligera que se ejecute rápidamente.

Los controladores de cliente no recibirán llamadas a EVT_PACKET_QUEUE_ADVANCE, EVT_PACKET_QUEUE_CANCEL o EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED después de que EvtPacketQueueStop devuelva. Además, se llama a EvtPacketQueueStop en el mismo contexto de ejecución, o subproceso, que EvtPacketQueueAdvance, EvtPacketQueueCancel y EvtPacketQueueSetNotificationEnabled, por lo que los controladores de cliente no necesitan sincronizar entre estas funciones de devolución de llamada para una instancia de cola individual.

Para obtener más información y un diagrama en el que se muestra el modelo de sondeo de ruta de acceso de datos netAdapterCx, consulte Transmisión y recepción de colas.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.27
Versión mínima de UMDF	2,33
Encabezado	netpacketqueue.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL