Funzione NetTxQueueNotifyMoreCompletedPacketsAvailable (nettxqueue.h)
Il driver client chiama NetTxQueueNotifyMoreCompletedPacketsAvailable per riprendere le operazioni della coda dopo che 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 per una coda di trasmissione netta.
Valore restituito
Nessuno
Osservazioni
Questa funzione deve essere chiamata solo quando il polling è disabilitato.
Dopo che NetAdapterCx chiama la routine di callback di un driver client EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED con NotificationEnabled impostato su TRUE, il client abilita l'interruzione hardware della coda. Quando il dispositivo genera un interrupt 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_RINGdella coda di trasmissione .
Il client deve chiamare solo NetTxQueueNotifyMoreCompletedPacketsAvailable una sola volta per abilitare la notifica. Se la chiamata più recente a EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED ha NotificationEnabled impostato 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à un no-op.
Fabbisogno
Requisito | Valore |
---|---|
piattaforma di destinazione | Universale |
versione minima di KMDF | 1.27 |
versione minima di UMDF | 2.33 |
intestazione | nettxqueue.h (include netadaptercx.h) |
IRQL | <= HIGH_LEVEL |