MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT fungsi panggilan balik (dot11wdi.h)

Penting

Topik ini adalah bagian dari model driver WDI yang dirilis dalam Windows 10. Model driver WDI berada dalam mode pemeliharaan dan hanya akan menerima perbaikan prioritas tinggi. WiFiCx adalah model driver Wi-Fi yang dirilis dalam Windows 11. Kami menyarankan agar Anda menggunakan WiFiCx untuk memanfaatkan fitur terbaru.

Fungsi panggilan balik TxSuspectFrameListAbort diimplementasikan oleh miniport IHV untuk memberi tahu TxEngine bahwa TxMgr telah mengidentifikasi bingkai yang dicurigai sebagai penyelesaian yang digantung atau tertunda untuk jangka waktu yang signifikan.

Sintaks

MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT MiniportWdiTxSuspectFrameListAbort;

void MiniportWdiTxSuspectFrameListAbort(
  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  UINT64 SuspectFrameContext,
  UINT16 NumSuspectFrames,
  PNET_BUFFER_LIST *SuspectFrameList
)
{...}

Parameter

MiniportTalTxRxContext

Handel perangkat TAL yang dikembalikan oleh miniport IHV di MiniportWdiTalTxRxInitialize.

SuspectFrameContext

Informasi konteks tentang bingkai yang dicurigai.

NumSuspectFrames

Jumlah bingkai tersangka.

SuspectFrameList

Daftar bingkai yang dicurigai. Untuk informasi lebih lanjut, lihat bagian Keterangan.

Mengembalikan nilai

Tidak ada

Keterangan

Daftarkan implementasi Anda dari fungsi panggilan balik ini dengan mengatur anggota struktur NDIS_MINIPORT_WDI_DATA_HANDLERS yang sesuai.

Ini adalah handler opsional. Jika miniport IHV tidak menerapkan perilaku panggilan balik ini, itu tidak boleh mengatur penunjuk fungsi di NDIS_MINIPORT_WDI_DATA_HANDLERS dan WDI tidak akan memanggil handler ini. Namun, jika perilaku panggilan balik ini tidak diimplementasikan, penunjuk fungsi mungkin masih diatur jika miniport IHV menggunakan SuspectFrameList untuk mencatat status IHV untuk tujuan diagnostik.

Fungsi panggilan balik ini menginformasikan TxEngine bahwa TxMgr telah mengidentifikasi bingkai yang dicurigai sebagai penyelesaian yang digantung atau tertunda untuk jangka waktu yang signifikan. Array SuspectFrameList dari pointer NBL, di mana pointer Berikutnya tidak berlaku, mewakili bingkai yang TxMgr meminta penyelesaian prompt bahkan jika itu mengakibatkan bingkai tidak ditransmisikan melalui udara.

TxEngine mungkin memeriksa status NBL di array SuspectFrameList dengan memanggil TxQuerySuspectFrameStatus dari konteks TxSuspectFrameListAbort dengan SuspectFrameContext yang diteruskan ke handler. TxMgr tidak akan memanggil TxTargetDescDeinit untuk NBL apa pun di SuspectFrameList selama durasi TxSuspectFrameAbort, juga tidak akan menyelesaikan bingkai ke NDIS.

Jika TxEngine atau firmware tidak memiliki pengetahuan atau status untuk bingkai tersangka, tidak boleh mengeluarkan penyelesaian untuk bingkai tersangka tersebut, karena ini dapat menyebabkan kerusakan sistem dan/atau penyelesaian ganda.

Jika kios firmware atau kerusakan terdeteksi, pemberitahuan NDIS_STATUS_WDI_INDICATION_FIRMWARE_STALLED harus dilakukan untuk mencoba pemulihan.

Persyaratan

Persyaratan	Nilai
Header	dot11wdi.h