Função NetRxQueueNotifyMoreReceivedPacketsAvailable (netrxqueue.h)

  • Artigo

O driver do cliente chama NetRxQueueNotifyMoreReceivedPacketsAvailable para retomar as operações de fila depois que NetAdapterCx chama a rotina de retorno de chamada de evento EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED do cliente.

Sintaxe

void NetRxQueueNotifyMoreReceivedPacketsAvailable(
  [_In_] NETPACKETQUEUE PacketQueue
);

Parâmetros

[_In_] PacketQueue

Um identificador para um objeto de fila de recebimento líquido.

Retornar valor

Nenhum

Comentários

Essa função só deve ser chamada quando a sondagem estiver desabilitada.

Depois que NetAdapterCx chama a rotina de retorno de chamada de evento EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED de um driver de cliente com NotificationEnabled definido como TRUE, o cliente habilita a interrupção de hardware da fila. Quando o dispositivo gera uma interrupção de hardware, o cliente normalmente chama NetRxQueueNotifyMoreReceivedPacketsAvailable de sua função de retorno de chamada EVT_WDF_INTERRUPT_DPC , depois de concluir uma NET_PACKET pendente no NET_RING da fila de recebimento.

O cliente só deve chamar NetRxQueueNotifyMoreReceivedPacketsAvailable uma vez por habilitação da notificação. Se a chamada mais recente para EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED tiver NotificationEnabled definido como FALSE, o cliente deverá evitar invocar NetRxQueueNotifyMoreReceivedPacketsAvailable. Como NetAdapterCx invoca EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED repetidamente, o cliente pode perder alguns casos e chamar NetRxQueueNotifyMoreReceivedPacketsAvailable quando NotificationEnabled estiver definido como FALSE. Nesses casos, a chamada será uma no-op.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.27
Cabeçalho netrxqueue.h (inclua netadaptercx.h)
IRQL <= HIGH_LEVEL

Confira também

EVT_PACKET_QUEUE_ADVANCE

EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED