MINIPORT_WDI_TX_TARGET_DESC_INIT fungsi panggilan balik (dot11wdi.h)

Artikel
08/07/2023

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 MINIPORT_WDI_TX_TARGET_DESC_INIT mengaitkan deskriptor TX target buram dengan bidang NET_BUFFER_LIST (MiniportReserved[1 ]) dan (jika ada) mengisi bidang biaya TX (dalam unit kredit) di buffer WDI_FRAME_METADATANET_BUFFER_LIST (MiniportReserved[0]).

Ini adalah handler miniport WDI di dalam NDIS_MINIPORT_WDI_DATA_HANDLERS.

Catatan Anda harus mendeklarasikan fungsi dengan menggunakan jenis MINIPORT_WDI_TX_TARGET_DESC_INIT . Untuk informasi selengkapnya, lihat bagian Contoh berikut ini.

Sintaks

MINIPORT_WDI_TX_TARGET_DESC_INIT MiniportWdiTxTargetDescInit;

void MiniportWdiTxTargetDescInit(
  [in]  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in]  PNET_BUFFER_LIST pNBL,
  [out] NDIS_STATUS *pWifiStatus
)
{...}

Parameter

[in] MiniportTalTxRxContext

Handel perangkat TAL yang dikembalikan oleh miniport IHV dalam fungsi panggilan balik MINIPORT_WDI_TAL_TXRX_INITIALIZE .

[in] pNBL

Arahkan ke satu NET_BUFFER_LIST.

[out] pWifiStatus

Arahkan ke status yang diatur oleh IHV untuk menunjukkan hasil fungsi panggilan balik MINIPORT_WDI_TX_TARGET_DESC_INIT .

Nilai kembali

Tidak ada

Keterangan

Status NDIS_STATUS_RESOURCES hanya boleh digunakan ketika deskriptor Tx habis. Perilaku terbaik terjadi jika miniport IHV tidak menggunakan NDIS_STATUS_RESOURCES. Status apa pun selain NDIS_STATUS_SUCCESS dan NDIS_STATUS_RESOURCES harus digunakan untuk kesalahan lain yang menunjukkan miniport atau firmware IHV tidak dapat memproses NET_BUFFER_LIST.

Miniport IHV dapat menggunakan isi ulang di NET_BUFFER dengan menggunakan fungsi mundur dan maju NDIS yang sesuai. Awal offset paket harus dipulihkan sebelum atau dalam fungsi panggilan balik MINIPORT_WDI_TX_TARGET_DESC_DEINIT . TxMgr menentukan panjang bingkai selama waktu dequeue sehingga setiap perubahan pada panjang bingkai dalam fungsi panggilan balik MINIPORT_WDI_TX_TARGET_DESC_INIT disertakan dalam membatasi ukuran dequeue ke kuantum. Dalam hal ini, miniport IHV harus menyesuaikan kuantum dengan tepat untuk memperhitungkan delta.

Penting Miniport IHV tidak diizinkan untuk membuat indikasi apa pun dalam konteks panggilan ini. TxMgr menserialisasikan panggilan ke TxTargetDescInitHandler.

Contoh

Untuk menentukan fungsi panggilan balik MINIPORT_WDI_TX_TARGET_DESC_INIT , Anda harus terlebih dahulu memberikan deklarasi fungsi yang mengidentifikasi jenis fungsi yang Anda tentukan. Windows menyediakan sekumpulan tipe fungsi untuk pengandar. Mendeklarasikan fungsi menggunakan jenis fungsi membantu Analisis Kode untuk Driver, Pemverifikasi Driver Statis (SDV), dan alat verifikasi lainnya menemukan kesalahan, dan itu adalah persyaratan untuk menulis driver untuk sistem operasi Windows.

Misalnya, untuk menentukan fungsi panggilan balik MINIPORT_WDI_TX_TARGET_DESC_INIT yang diberi nama "MyTxTargetDescInit", gunakan jenis MINIPORT_WDI_TX_TARGET_DESC_INIT seperti yang ditunjukkan dalam contoh kode ini:

MINIPORT_WDI_TX_TARGET_DESC_INIT MyTxTargetDescInit;

Kemudian, terapkan fungsi Anda sebagai berikut:

_Use_decl_annotations_
VOID
 MyTxTargetDescInit(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    PNET_BUFFER_LIST pNBL,
    NDIS_STATUS *pWifiStatus
    )
  {...}

Jenis fungsi MINIPORT_WDI_TX_TARGET_DESC_INIT ditentukan dalam file header dot11wdi.h. Untuk mengidentifikasi kesalahan secara lebih akurat saat Anda menjalankan alat analisis kode, pastikan untuk menambahkan anotasi Use_decl_annotations ke definisi fungsi Anda. Anotasi Use_decl_annotations memastikan bahwa anotasi yang diterapkan ke jenis fungsi MINIPORT_WDI_TX_TARGET_DESC_INIT dalam file header digunakan. Untuk informasi selengkapnya tentang persyaratan untuk deklarasi fungsi, lihat Mendeklarasikan Fungsi dengan Menggunakan Jenis Peran Fungsi untuk Driver NDIS.

Untuk informasi tentang Use_decl_annotations, lihat Perilaku Fungsi Anotasi.