Função NetTxQueueNotifyMoreCompletedPacketsAvailable (nettxqueue.h)

  • Artigo

O driver cliente chama NetTxQueueNotifyMoreCompletedPacketsAvailable 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 NetTxQueueNotifyMoreCompletedPacketsAvailable(
  [_In_] NETPACKETQUEUE PacketQueue
);

Parâmetros

[_In_] PacketQueue

Um identificador para uma fila de transmissão de rede.

Retornar valor

Nenhum

Comentários

Essa função só deve ser chamada quando a sondagem está 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 NetTxQueueNotifyMoreCompletedPacketsAvailable 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 transmissão.

O cliente só deve chamar NetTxQueueNotifyMoreCompletedPacketsAvailable 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 NetTxQueueNotifyMoreCompletedPacketsAvailable. Como NetAdapterCx invoca EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED repetidamente, o cliente pode perder alguns casos e chamar NetTxQueueNotifyMoreCompletedPacketsAvailable quando NotificationEnabled estiver definido como FALSE. Nesses casos, a chamada será não operacional.

Requisitos

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

Confira também

EVT_PACKET_QUEUE_ADVANCE

EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED