OPEN_NDK_ADAPTER_HANDLER fungsi panggilan balik (ndisndk.h)

Artikel
08/07/2023

Fungsi OpenNDKAdapterHandler (OPEN_NDK_ADAPTER_HANDLER) membuka instans adaptor NDK pada adaptor miniport NDIS berkemampuan NDK.

Sintaks

OPEN_NDK_ADAPTER_HANDLER OpenNdkAdapterHandler;

NDIS_STATUS OpenNdkAdapterHandler(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] PNDIS_OPEN_NDK_ADAPTER_PARAMETERS Parameters,
       NDK_ADAPTER **ppNdkAdapter
)
{...}

Parameter

[in] MiniportAdapterContext

Handel ke area konteks yang dialokasikan driver miniport dalam fungsi MiniportInitializeEx-nya . Driver miniport menggunakan area konteks ini untuk mempertahankan informasi status untuk adaptor miniport NDIS.

[in] Parameters

Penunjuk ke struktur NDIS_OPEN_NDK_ADAPTER_PARAMETERS yang menentukan parameter input untuk membuka instans NDK_ADAPTER .

Struktur NDIS_OPEN_NDK_ADAPTER_PARAMETERS harus menentukan versi utama NDKPI, dan versi minor NDKPI terendah yang dapat didukung konsumen NDK.

Jika penyedia tidak mendukung versi utama yang ditentukan konsumen, penyedia harus gagal dalam permintaan dengan NDIS_STATUS_BAD_VERSION.

Jika penyedia mendukung versi utama yang ditentukan konsumen dan versi minor yang ditentukan kurang dari atau sama dengan versi minor tertinggi yang didukung penyedia, penyedia harus berhasil meminta dan menggunakan versi minor tertinggi yang didukung penyedia.

Misalnya, jika konsumen meminta versi 1.0, dan penyedia mendukung 1.1, penyedia harus melaporkan versi 1.1 di struktur NDK_ADAPTER_INFO dan header objek NDK.

Catatan Versi minor yang lebih tinggi di penyedia selalu sepenuhnya kompatibel dengan versi minor yang lebih rendah (yaitu, superset dari).

Jika penyedia mendukung versi utama yang ditentukan konsumen dan versi minor yang ditentukan lebih besar dari versi minor tertinggi yang didukung penyedia, penyedia harus gagal dalam permintaan dengan NDIS_STATUS_BAD_VERSION.

ppNdkAdapter

Penunjuk ke variabel yang memegang penunjuk ke struktur NDK_ADAPTER . Saat dikembalikan dari OPEN_NDK_ADAPTER_HANDLER, struktur NDK_ADAPTER yang direferensikan oleh ppNdkAdapter mengidentifikasi instans adaptor NDK yang baru dibuka.

Nilai kembali

OPEN_NDK_ADAPTER_HANDLER bisa mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	Instans adaptor NDK berhasil dibuka.
NDIS_STATUS_BAD_VERSION	Nomor versi yang diminta tidak didukung.
NDIS_STATUS_ADAPTER_NOT_READY	Fungsionalitas NDK adaptor miniport tidak diaktifkan.
NDIS_STATUS_RESOURCES	NDIS tidak dapat membuka adaptor NDK karena sumber daya yang tidak mencukupi.

Keterangan

OPEN_NDK_ADAPTER_HANDLER membuka instans NDK_ADAPTER pada adaptor miniport NDIS berkemampu NDK. Beberapa instans NDK_ADAPTER dapat dibuat pada adaptor miniport NDIS yang sama. Setiap instans NDK_ADAPTER berisi pointer ke tabel fungsi pengiriman yang mengimplementasikan antarmuka pemrograman aplikasi NDK. Driver miniport memanggil fungsi CLOSE_NDK_ADAPTER_HANDLER untuk menutup instans adaptor NDK dan merilis sumber daya terkait.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung, Didukung di NDIS 6.30 dan yang lebih baru.
Server minimum yang didukung	Windows Server 2012
Target Platform	Windows
Header	ndisndk.h
IRQL	PASSIVE_LEVEL