NDIS_WDI_TX_DEQUEUE_IND fungsi panggilan balik (dot11wdi.h)

Artikel
02/23/2024

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 NdisWdiTxDequeueIndication dipanggil dalam konteks MiniportWdiTxDataSend atau MiniportWdiTxTalSend oleh miniport IHV untuk menghapus bingkai antrean dari WDI ke miniport IHV.

Ini adalah panggilan balik di dalam NDIS_WDI_DATA_API.

Sintaks

NDIS_WDI_TX_DEQUEUE_IND NdisWdiTxDequeueInd;

void NdisWdiTxDequeueInd(
  [in]  NDIS_HANDLE NdisMiniportDataPathHandle,
  [in]  UINT32 Quantum,
  [in]  UINT8 MaxNumFrames,
  [in]  UINT16 Credit,
  [out] PNET_BUFFER_LIST *ppNBL
)
{...}

Parameter

[in] NdisMiniportDataPathHandle

NdisMiniportDataPathHandle melewati miniport IHV di MiniportWdiTalTxRxInitialize.

[in] Quantum

Kuantum. Untuk informasi selengkapnya, lihat bagian Host - target penjadwalan transfer TX di jalur WDI TX.

[in] MaxNumFrames

Jumlah bingkai maksimum.

[in] Credit

Nilai kredit. Untuk informasi selengkapnya, lihat Skema kredit target dan bagian mekanisme jeda/lanjutkan di jalur WDI TX.

[out] ppNBL

Penunjuk ke penunjuk ke rantai NET_BUFFER_LIST yang diantrekan oleh WDI.

Nilai kembali

Tidak ada

Keterangan

Subset parameter mungkin tidak berlaku untuk perangkat. Misalnya, jumlah bingkai maksimum mungkin tidak berlaku untuk perangkat penyimpanan dan penerusan (antarmuka bus berbasis pesan).

Parameter berikut diabaikan oleh TxMgr dalam keadaan ini.

Quantum jika diatur ke WDI_TX_QUANTUM_INVALID (0xFFFFFFFF)
MaxNumFrames jika diatur ke WDI_TX_MAX_FRAME_COUNT_INVALID (0xFF)
Kredit jika diatur ke WDI_TX_CREDIT_INVALID (0xFFFF)

TAL harus memberikan parameter yang akurat jika memungkinkan untuk menjamin kewajaran dan menghindari sumber daya TIL/target yang luar biasa.

Jika TAL tidak memiliki kredit yang cukup untuk menghapus antrean bingkai biaya maksimum, TAL harus mengeluarkan NdisWdiTxSendPauseIndication alih-alih NdisWdiTxDequeueIndication.

TxMgr dapat mengembalikan daftar NET_BUFFER_LIST yang melebihi batas jumlah bingkai, biaya bingkai, atau kuantum. Ini hanya terjadi jika bingkai sedang diantrekan ulang/diputar ulang setelah dikirim selesai dengan status Ditunda dan dengan nomor urutan yang identik, yang menunjukkan bahwa bingkai awalnya ditransmisikan sebagai bagian dari satu A-MSDU.