Función NetRxQueueNotifyMoreReceivedPacketsAvailable (netrxqueue.h)

  • Artículo

El controlador cliente llama a NetRxQueueNotifyMoreReceivedPacketsAvailable para reanudar las operaciones de cola después de que NetAdapterCx llame a la rutina de devolución de llamada de eventos EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED del cliente.

Sintaxis

void NetRxQueueNotifyMoreReceivedPacketsAvailable(
  [_In_] NETPACKETQUEUE PacketQueue
);

Parámetros

[_In_] PacketQueue

Identificador de un objeto de cola de recepción neto.

Valor devuelto

None

Observaciones

Solo se debe llamar a esta función cuando el sondeo está deshabilitado.

Después de que NetAdapterCx llame a la rutina de devolución de llamada de eventos EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED de un controlador cliente con NotificationEnabled establecido en TRUE, el cliente habilita la interrupción del hardware de la cola. Cuando el dispositivo genera una interrupción de hardware, el cliente normalmente llama a NetRxQueueNotifyMoreReceivedPacketsAvailable desde su función de devolución de llamada EVT_WDF_INTERRUPT_DPC , una vez completada una NET_PACKET pendiente en la NET_RING de la cola de recepción.

El cliente solo debe llamar a NetRxQueueNotifyMoreReceivedPacketsAvailable una vez por habilitar la notificación. Si la llamada más reciente a EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED tiene NotificationEnabled establecido en FALSE, el cliente debe evitar invocar NetRxQueueNotifyMoreReceivedPacketsAvailable. Dado que NetAdapterCx invoca EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED repetidamente, el cliente puede perder algunos casos y llamar a NetRxQueueNotifyMoreReceivedPacketsAvailable cuando NotificationEnabled está establecido en FALSE. En estos casos, la llamada será sin operación.

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.27
Encabezado netrxqueue.h (include netadaptercx.h)
IRQL <= HIGH_LEVEL

Consulte también

EVT_PACKET_QUEUE_ADVANCE

EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED