Fungsi NdisIfRegisterProvider (ndis.h)

  • Artikel

Fungsi NdisIfRegisterProvider mendaftarkan penyedia antarmuka jaringan NDIS.

Sintaks

NDIS_STATUS NdisIfRegisterProvider(
  [in] PNDIS_IF_PROVIDER_CHARACTERISTICS ProviderCharacteristics,
  [in] NDIS_HANDLE                       IfProviderContext,
       PNDIS_HANDLE                      pNdisIfProviderHandle
);

Parameter

[in] ProviderCharacteristics

Penunjuk ke penelepon yang disediakan NDIS_IF_PROVIDER_CHARACTERISTICS struktur. Struktur ini mendefinisikan karakteristik penyedia, termasuk titik masuk untuk fungsi panggilan balik penyedianya.

[in] IfProviderContext

Handel ke area konteks yang disediakan pemanggil untuk penyedia antarmuka jaringan ini. Atur parameter ini ke NULL jika tidak ada area konteks.

pNdisIfProviderHandle

Penunjuk ke variabel handel yang disediakan penelepon. Jika operasi pendaftaran berhasil, NDIS menulis handel ke variabel ini yang mengidentifikasi penyedia antarmuka jaringan. Penyedia antarmuka harus mempertahankan handel ini untuk digunakan dalam panggilan berikutnya yang memerlukan handel penyedia antarmuka.

Nilai kembali

NdisIfRegisterProvider mengembalikan salah satu nilai status berikut:

Menampilkan kode Deskripsi
NDIS_STATUS_SUCCESS
 Operasi berhasil diselesaikan.
NDIS_STATUS_RESOURCES
 Operasi gagal karena sumber daya yang tidak mencukup.
NDIS_STATUS_INVALID_PARAMETER
 NdisIfRegisterProvider gagal mendaftarkan penyedia karena NDIS_IF_PROVIDER_CHARACTERISTICS struktur pada parameter ProviderCharacteristics berisi data anggota yang tidak valid.
NDIS_STATUS_NOT_SUPPORTED
 NdisIfRegisterProvider gagal mendaftarkan penyedia karena anggota Header di NDIS_IF_PROVIDER_CHARACTERISTICS menentukan versi struktur yang tidak didukung.

Keterangan

Driver NDIS memanggil fungsi NdisIfRegisterProvider sekali selama inisialisasi untuk mendaftar sebagai penyedia antarmuka NDIS. Misalnya, driver dapat memanggil NdisIfRegisterProvider dari rutinitas DriverEntry-nya . Penyedia antarmuka adalah komponen perangkat lunak yang mengelola antarmuka jaringan untuk mendukung MIB ( RFC 2863).

Untuk menangani permintaan OID penyedia antarmuka, penyedia antarmuka menyediakan titik masuk untuk fungsi panggilan balik di NDIS_IF_PROVIDER_CHARACTERISTICS struktur pada parameter ProviderCharacteristicsdari NdisIfRegisterProvider.

Penyedia antarmuka NDIS memanggil fungsi NdisIfRegisterInterface untuk mendaftarkan antarmuka jaringan. Penyedia dapat mendaftarkan beberapa antarmuka.

Jika NdisIfRegisterProvider berhasil, NdisIfRegisterProvider mengembalikan handel di lokasi yang dituju parameter pNdisProviderHandle . Penyedia antarmuka harus mempertahankan handel ini untuk digunakan dalam panggilan berikutnya yang memerlukan handel penyedia antarmuka. Misalnya, driver harus memanggil NdisIfDeregisterProvider sebelum driver dibongkar.

Komponen yang bukan lagi penyedia antarmuka dapat memanggil fungsi NdisIfDeregisterProvider kapan saja untuk merilis sumber daya penyedia antarmuka yang dialokasikan NDIS saat driver bernama NdisIfRegisterProvider.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung di NDIS 6.0 dan yang lebih baru.
Target Platform Desktop
Header ndis.h (termasuk Ndis.h)
Pustaka Ndis.lib
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI Irql_Interfaces_Function(ndis)

Lihat juga

DriverEntry

NDIS_IF_PROVIDER_CHARACTERISTICS

NdisIfDeregisterProvider

NdisIfRegisterInterface