DOT11EXTIHV_INIT_SERVICE fungsi panggilan balik (wlanihv.h)

Artikel
02/27/2024

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.

Sistem operasi memanggil fungsi Dot11ExtIhvInitService untuk menginisialisasi DLL Ekstensi IHV serta antarmuka API antara sistem operasi dan DLL.

Sintaks

DOT11EXTIHV_INIT_SERVICE Dot11extihvInitService;

DWORD Dot11extihvInitService(
  [in]  DWORD dwVerNumUsed,
  [in]  PDOT11EXT_APIS pDot11ExtAPI,
        LPVOID pvReserved,
  [out] PDOT11EXT_IHV_HANDLERS pDot11IHVHandlers
)
{...}

Parameter

[in] dwVerNumUsed

Versi antarmuka yang digunakan oleh sistem operasi. Nilai parameter ini harus berada di antara rentang nomor versi yang dikembalikan dalam parameter pDot11IHVVersionInfo dari Dot11ExtIhvGetVersionInfo Fungsi Handler IHV.

[in] pDot11ExtAPI

Penunjuk ke struktur DOT11EXT_APIS , yang berisi alamat fungsi Ekstensibilitas IHV yang didukung oleh sistem operasi. Sistem operasi memformat parameter ini dengan alamat fungsi sebelum melakukan panggilan ke fungsi Dot11ExtIhvInitService .

pvReserved

Parameter ini disediakan untuk digunakan oleh sistem operasi.

[out] pDot11IHVHandlers

Penunjuk ke struktur DOT11EXT_IHV_HANDLERS , yang berisi alamat fungsi Handler IHV yang didukung oleh DLL Ekstensi IHV. DLL memformat parameter ini dengan alamat fungsi sebelum kembali dari panggilan ke fungsi Dot11ExtIhvInitService .

Nilai kembali

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

Keterangan

Sistem operasi memanggil fungsi Dot11ExtIhvInitService segera setelah panggilan ke Fungsi Dot11ExtIhvGetVersionInfo . Ketika dipanggil, Dot11ExtIhvInitService harus menginisialisasi DLL Ekstensi IHV seperlunya. Ketika fungsi kembali, DLL harus siap untuk menerima panggilan tambahan ke fungsi Handler IHV.

Tidak seperti bagaimana ia memperlakukan fungsi Ekstensi dan Handler IHV lainnya yang alamatnya diselesaikan melalui parameter pDot11IHVHandlers , sistem operasi menyelesaikan alamat fungsi Dot11ExtIhvInitService dengan memanggil fungsi GetProcAddress . Akibatnya, pengembang DLL Ekstensi IHV harus mengikuti panduan ini.

DLL harus mengimplementasikan fungsi bernama Dot11ExtIhvInitService, yang memiliki format yang dijelaskan dalam topik ini.
Pernyataan EXPORTS dari file definisi modul sumber (.def), yang digunakan untuk membangun DLL Ekstensi IHV, harus berisi entri nama fungsi untuk fungsi Dot11ExtIhvInitService .

Untuk informasi selengkapnya tentang GetProcAddress, lihat dokumentasi Microsoft Windows SDK.

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

DOT11EXT_APIS

DOT11EXT_IHV_HANDLERS

Dot11ExtIhvGetVersionInfo

Share via