Fungsi NdisIfFreeNetLuidIndex (ndis.h)

  • Artikel

Fungsi NdisIfFreeNetLuidIndex membebaskan antarmuka jaringan NET_LUID indeks yang sebelumnya dialokasikan oleh panggilan ke Fungsi NdisIfAllocateNetLuidIndex .

Sintaks

NDIS_STATUS NdisIfFreeNetLuidIndex(
       NET_IFTYPE ifType,
  [in] UINT32     NetLuidIndex
);

Parameter

ifType

Jenis antarmuka tempat indeks dialokasikan. Pemanggil harus memberikan nilai yang sama dengan yang digunakan saat mengalokasikan indeks NET_LUID dengan NdisIfAllocateNetLuidIndex. Untuk daftar jenis antarmuka, lihat Jenis Antarmuka NDIS.

[in] NetLuidIndex

Nilai indeks NET_LUID yang harus dikosongkan oleh NDIS. Indeks ini dialokasikan dalam panggilan sebelumnya ke NdisIfAllocateNetLuidIndex.

Nilai kembali

NdisIfFreeNetLuidIndex mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
NDIS_STATUS_SUCCESS
 Operasi berhasil diselesaikan.
DIS_STATUS_INVALID_PARAMETER
 NdisIfFreeNetLuidIndex gagal karena parameter NetLuidIndex menentukan indeks yang tidak dialokasikan untuk jenis yang ditentukan parameter IfType .
 

Jika panggilan ke NdisIfFreeNetLuidIndex gagal, penyedia antarmuka harus menghapus informasi apa pun yang disimpannya di penyimpanan persisten yang terkait dengan indeks. Menghapus informasi akan memastikan bahwa penyedia tidak terus mencoba membebaskan indeks yang sudah dikosongkan setelah komputer dimulai ulang.

Keterangan

Penyedia antarmuka NDIS memanggil fungsi NdisIfFreeNetLuidIndex untuk membebaskan indeks NET_LUID . Penyedia antarmuka harus membebaskan indeks NET_LUID hanya jika antarmuka tidak akan digunakan lagi di komputer lokal.

NdisIfFreeNetLuidIndex mengembalikan indeks NET_LUID yang dialokasikan sebelumnya ke NDIS untuk kemungkinan realokasi ke antarmuka lain. Pemanggil harus meneruskan jenis antarmuka yang sama di IfType yang digunakannya saat memanggil Fungsi NdisIfAllocateNetLuidIndex untuk mengalokasikan indeks NET_LUID.

Penyedia tidak boleh menggunakan indeks NET_LUID yang dibebaskan atau nilai NET_LUID terkait dalam panggilan fungsi NDIS lainnya setelah memanggil NdisIfFreeNetLuidIndex.

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

NET_LUID

NdisIfAllocateNetLuidIndex