Makro NdisFreeString (ndis.h)

Artikel
03/08/2023

Fungsi NdisFreeString merilis penyimpanan yang dialokasikan oleh NdisInitializeString untuk string yang di-buffer.

Sintaks

void NdisFreeString(
  [in]  String
);

Parameter

[in] String

Nilai jenis NDIS_STRING yang menjelaskan string menjadi bebas. Untuk Windows 2000 dan yang lebih baru, NDIS menentukan jenis NDIS_STRING sebagai jenis UNICODE_STRING .

Nilai kembali

Tidak ada

Keterangan

Driver NDIS biasanya memanggil fungsi NdisInitializeString selama inisialisasi--misalnya, untuk menyiapkan nama yang diteruskan ke fungsi Konfigurasi NdisXxx. Untuk setiap panggilan yang dilakukan driver ke NdisInitializeString, driver harus melakukan panggilan yang sesuai ke NdisFreeString. Saat merilis buffer string yang dialokasikan selama inisialisasi, driver harus memanggil NdisFreeString sebelum fungsi inisialisasi driver mengembalikan kontrol.

NdisFreeString harus digunakan hanya untuk membebaskan buffer yang dialokasikan dengan NdisInitializeString.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver yang ada di NDIS 6.0 dan yang lebih baru, tetapi driver baru harus menggunakan RtlFreeAnsiString atau RtlFreeUnicodeString sebagai gantinya.
Target Platform	Desktop
Header	ndis.h (termasuk Ndis.h)
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	Irql_Miscellaneous_Function(ndis)