DOT11EXT_SEND_PACKET fungsi panggilan balik (wlanihv.h)

  • Artikel
Penting Antarmuka LAN Nirkabel Native 802.11 tidak digunakan lagi di Windows 10 dan yang lebih baru. Silakan gunakan WLAN Device Driver Interface (WDI) sebagai gantinya. Untuk informasi selengkapnya tentang WDI, lihat WLAN Universal Windows driver model.
 
DLL Ekstensi IHV memanggil fungsi Dot11ExtSendPacket untuk mengirimkan paket melalui adaptor LAN nirkabel (WLAN).

Sintaks

DOT11EXT_SEND_PACKET Dot11extSendPacket;

DWORD Dot11extSendPacket(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uPacketLen,
  [in]           LPVOID pvPacket,
  [in, optional] HANDLE hSendCompletion
)
{...}

Parameter

[in, optional] hDot11SvcHandle

Handel yang digunakan oleh sistem operasi untuk mereferensikan adaptor WLAN. Nilai handel ini ditentukan melalui panggilan sebelumnya ke fungsi Handler IHV Dot11ExtIhvInitAdapter .

[in] uPacketLen

Panjangnya, dalam byte, dari buffer yang dialokasikan pemanggil yang dirujuk oleh parameter pvPacket .

[in] pvPacket

Penunjuk ke buffer yang dialokasikan pemanggil yang berisi data yang akan dikirimkan, seperti yang dijelaskan di bagian Keterangan.

[in, optional] hSendCompletion

Nilai handel yang secara unik mengidentifikasi paket kirim.

Ketika adaptor WLAN menyelesaikan operasi pengiriman, sistem operasi memberi tahu DLL Ekstensi IHV melalui panggilan ke Dot11ExtIhvSendPacketCompletion Fungsi Handler IHV. Saat melakukan panggilan ini, sistem operasi melewati nilai handel paket melalui parameter hSendCompletion .

Mengembalikan nilai

Jika panggilan berhasil, fungsi akan mengembalikan ERROR_SUCCESS. Jika tidak, ia mengembalikan kode kesalahan yang ditentukan dalam Winerror.h.

Keterangan

DLL Ekstensi IHV harus mengikuti panduan ini saat memanggil fungsi Dot11ExtSendPacket .

  • Paket yang dikirim melalui panggilan fungsi Dot11ExtSendPacket akan selesai secara asinkron. DLL Ekstensi IHV tidak boleh membebaskan memori yang direferensikan oleh parameter pvPacket hingga Dot11ExtIhvSendPacketCompletion Fungsi Handler IHV dipanggil dengan nilai handel yang sama dengan parameter hSendCompletion .
  • DLL Ekstensi IHV harus mengatur parameter hSendCompletion ke nilai yang secara unik mengidentifikasi data paket yang direferensikan oleh parameter pvPacket .
Untuk informasi selengkapnya tentang fungsi Handler IHV, lihat Fungsi Handler IHV Native 802.11.

Buffer yang ditujukkan oleh pvPacket harus berisi data paket berikut, yang ditentukan dalam urutan byte jaringan:

  • Alamat MAC tujuan (6 byte), diformat sesuai dengan pedoman yang dibahas dalam Manajemen Header MAC 802.11
  • IEEE EtherType (2 byte)
  • Payload
Data paket ini diteruskan ke driver miniport.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Target Platform Desktop
Header wlanihv.h (termasuk Wlanihv.h)

Lihat juga

Fungsi Handler IHV Asli 802.11

Dot11ExtIhvSendPacketCompletion

Dot11ExtIhvInitAdapter

Manajemen Header MAC 802.11