EVT_PACKET_QUEUE_STOP fungsi panggilan balik (netpacketqueue.h)

Artikel
02/29/2024

Fungsi panggilan balik EvtPacketQueueStop adalah panggilan balik opsional yang diterapkan oleh driver klien untuk menghentikan jalur data untuk antrean paket.

Sintaks

EVT_PACKET_QUEUE_STOP EvtPacketQueueStop;

void EvtPacketQueueStop(
  [_In_] NETPACKETQUEUE PacketQueue
)
{...}

Parameter

[_In_] PacketQueue

Handel ke antrean paket.

Nilai kembali

Tidak ada

Keterangan

Ini adalah panggilan balik opsional. Daftarkan fungsi panggilan balik ini di panggilan balik EVT_NET_ADAPTER_CREATE_TX(rxQueueContext)QUEUE Anda. Atur anggota struktur NET_PACKET_QUEUE_CONFIG yang sesuai setelah Anda menginisialisasi struktur dengan NET_PACKET_QUEUE_CONFIG_INIT, lalu panggil NetTx(rxQueueContext)QueueCreate.

Panggilan balik ini tidak mengembalikan nilai dan oleh karena itu seharusnya tidak gagal, jadi panggilan balik ini harus menjadi fungsi ringan yang dijalankan dengan cepat.

Driver klien tidak akan menerima panggilan ke EVT_PACKET_QUEUE_ADVANCE, EVT_PACKET_QUEUE_CANCEL, atau EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED setelah EvtPacketQueueStop kembali. Selain itu, EvtPacketQueueStop dipanggil dalam konteks eksekusi yang sama, atau utas, seperti EvtPacketQueueAdvance, EvtPacketQueueCancel, dan EvtPacketQueueSetNotificationEnabled, sehingga driver klien tidak perlu menyinkronkan antara fungsi panggilan balik ini untuk instans antrean individual.

Untuk informasi selengkapnya dan diagram yang memperlihatkan model polling jalur data NetAdapterCx, lihat Mengirimkan dan menerima antrean.