Funzione NetTxQueueNotifyMoreCompletedPacketsAvailable (nettxqueue.h)
Il driver client chiama NetTxQueueNotifyMoreCompletedPacketsAvailable per riprendere le operazioni di coda dopo NetAdapterCx chiama la routine di callback dell'evento EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED del client.
Sintassi
void NetTxQueueNotifyMoreCompletedPacketsAvailable(
[_In_] NETPACKETQUEUE PacketQueue
);
Parametri
[_In_] PacketQueue
Handle in una coda di trasmissione net.
Valore restituito
nessuno
Osservazioni
Questa funzione deve essere chiamata solo quando il polling è disabilitato.
Dopo che NetAdapterCx chiama la routine di callback degli eventi di EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED di un driver client con NotificationEnabled impostata su TRUE, il client abilita l'interruzione hardware della coda. Quando il dispositivo genera un interruzione hardware, il client chiama in genere NetTxQueueNotifyMoreCompletedPacketsAvailable dalla relativa funzione di callback *EVT_WDF_INTERRUPT_DPC, dopo aver completato un NET_PACKET in sospeso nella NET_RING della coda di trasmissione.
Il client deve chiamare solo NetTxQueueNotifyMoreCompletedPacketsAvailable una volta per abilitare la notifica. Se la chiamata più recente a EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED dispone di NotificationEnabled impostata su FALSE, il client deve evitare di richiamare NetTxQueueNotifyMoreCompletedPacketsAvailable. Poiché NetAdapterCx richiama ripetutamente EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED , il client potrebbe perdere alcuni casi e chiamare NetTxQueueNotifyMoreCompletedPacketsAvailable quando NotificationEnabled è impostato su FALSE. In questi casi, la chiamata sarà no-op.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Universale |
Versione KMDF minima | 1.27 |
Versione UMDF minima | 2.33 |
Intestazione | nettxqueue.h (include netadaptercx.h) |
IRQL | <= HIGH_LEVEL |